MCP Server Python

🚀 MCP Server Demo (Python Version)

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

The server runs using uvicorn by default and listens on port 8000. To expose the server to the network, use the sse transport.

🚀 Quick Start

📦 Installation

1. Create and activate a virtual environment

Run the following commands to set up the 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

Verifying Server Operation

You can use the following commands to verify if the server is running on port 8000:

• Check active connections:

  netstat -n | grep 8000
  

• Check the process occupying the port:

  lsof -i :8000
  

• Test the server using curl:

  curl http://0.0.0.0:8000/sse
  

🧪 Running Tests

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

# Install test dependencies
pip install -r requirements.txt

# Run tests with detailed output
pytest -v

# Run tests to generate a coverage report
pytest --cov=.

Test Scope

The test suite includes the following:

• Basic functionality tests (addition and subtraction)
• Input validation and type checking
• Large number boundary cases
• API endpoint tests (greetings)

All tests are located in test_server.py and cover:

• The add() function
• The subtract() function
• The get_greeting() function
• Type error handling
• Boundary case handling

🛠️ Integrating with Tools

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

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

⚠️ Important Note

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

If you encounter any issues, feel free to contribute or submit an issue!