mcp-simple-demo

Overview

This repository provides a straightforward implementation of the Model Context Protocol (MCP) in Python. It includes a server with two sample tools (hello_world and add) and a client for testing interactions. The README is well-structured with clear installation instructions, usage examples, and protocol details. The project demonstrates the fundamental MCP concepts including server setup, tool definition, and client-server communication patterns.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• hello_worldname?: string

  Returns a greeting message

  Try:HelloTry:Say hello to JohnTry:Greet Alice
• adda: number, b: number

  Adds two numbers

  Try:Add 5 and 3Try:What's 7 plus 2?Try:Calculate 10 + 4

Comparable tools

Installation

# Clone the repository
git clone https://github.com/arjunprabhulal/mcp-simple-demo.git
cd mcp-simple-demo

# Install dependencies
pip install -r requirements.txt

# Or install manually
pip install mcp llama-index llama-index-tools-mcp requests

{
  "mcpServers": {
    "simple-demo": {
      "command": "python",
      "args": ["/path/to/mcp-simple-demo/server.py"]
    }
  }
}

FAQ

What tools are included in this demo?

The demo includes two simple tools: 'hello_world' (returns a greeting) and 'add' (performs addition of two numbers).

How can I test the server?

Use the provided client.py script with commands like 'python client.py tools' to list available tools, or 'python client.py add 5 3' to call the add tool.

Compare mcp-simple-demo with