MCP Server Demo in python

This repository contains a simple implementation of a Model Communication Protocol (MCP) server using Python. The server is designed to demonstrate the basic functionality of an MCP server and can be used for testing and development purposes.

The server uses uvicorn by default, running on port 8000. To expose the server over the network, use the sse transport.

---

Setup Instructions

1. Create and Activate a Virtual Environment

Run the following commands to set up your Python environment:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

---

Starting the Server

To start the server, run:

python3 server.py

Verify the Server is Running

You can verify that the server is running on port 8000 using the following commands:

• Check active connections:

  netstat -n | grep 8000
  

• Check processes using the port:

  lsof -i :8000
  

• Test the server with curl:

  curl http://0.0.0.0:8000/sse
  

---

Running Tests

The project includes a comprehensive test suite using pytest. To run the tests:

# Install test dependencies
pip install -r requirements.txt

# Run tests with verbose output
pytest -v

# Run tests with coverage report
pytest --cov=.

Test Coverage

The test suite includes:

• Basic functionality tests for addition and subtraction
• Input validation and type checking
• Edge cases with large numbers
• API endpoint testing for greetings

All tests are located in test_server.py and cover:

• add() function
• subtract() function
• get_greeting() function
• Type error handling
• Edge cases handling

---

Tools Using the Server

To integrate this server with tools like Cursor or Claude, use the following mcp.json configuration file:

{
  "mcpServers": {
    "demo-server": {
      "transport": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

---

Notes

• By default, the server uses stdio transport. To expose it over the network, ensure you configure it to use sse transport.
• The server runs on localhost and listens on port 8000 using uvicorn.

Feel free to contribute or open issues if you encounter any problems!