Py MCP Sse

🚀 MCP Client and Server Sample Implementation (Python Version)

This project was established on March 30, 2025. It is a sample implementation of an MCP client and an MCP server (Python version).

It is an optimized implementation based on https://github.com/sidharthrajaram/mcp-sse. [The original project is based on the original discussion at https://github.com/modelcontextprotocol/python-sdk/issues/145. You can download the original project for more instructions].

The original version was implemented using ANTHROPIC LLM. This version has been adjusted to use the LLM transit call platform of OpenRouter.ai.

🚀 Quick Start

SSE-based MCP Server and Client

• mcp_server.py is an SSE-based MCP server that provides a book search tool based on the Project Gutenberg API. It is adapted from the example STDIO server implementation in the MCP documentation.
• client.py is an MCP client that can connect to and use the tools provided by the SSE-based MCP server. It is adapted from the example STDIO client implementation in the MCP documentation.

✨ Features

• Built on the foundation of https://github.com/sidharthrajaram/mcp-sse with optimizations.
• Switched from using ANTHROPIC LLM to the LLM transit call platform of OpenRouter.ai.

📦 Installation

System Requirements

• Python 3.13 or higher
• uv package manager (recommended) or pip

Steps

1. Clone the project

git clone [your-repository-url]
cd jay-py-mcp-sse

2. Environment configuration

Using uv (recommended):

# Install uv (if not installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a virtual environment and install dependencies
uv venv
uv pip install .

Or using traditional pip:

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/MacOS
# or
.venv\Scripts\activate  # Windows

# Install dependencies
pip install .

3. Configure environment variables

Copy the environment variable example file and fill in the necessary information:

cp .env.sample .env

Edit the .env file and fill in your OpenRouter API key:

OPENROUTER_API_KEY=your_api_key_here

💻 Usage Examples

Run the service

1. Start the server

uv run mcp_server.py

Or specify the interface and port:

uv run mcp_server.py --interface "0.0.0.0" --port 8000

2. Start the client

uv run client.py

Example output

The following is an example output during runtime:

[2025-03-30T16:00:00+00:00] INFO - Server is running on http://localhost:8000
[2025-03-30T16:00:01+00:00] INFO - Client connected to server at http://localhost:8000
[2025-03-30T16:00:02+00:00] INFO - Available tools: search_books, recommend_books

📚 Documentation

Project Structure

jay-py-mcp-sse/
├── mcp_server.py          # SSE-based MCP server implementation
├── client.py              # MCP client implementation
├── README.md               # Project documentation
└── .env.sample            # Environment variable example file

Troubleshooting

1. Check the Python version
   • Ensure that you are using Python 3.13 or higher.
2. Check the environment variable configuration
   • Ensure that the OPENROUTER_API_KEY in the .env file is correctly filled in.
3. Startup issues
   • If the server or client fails to start, check the error information in the console output.
   • Ensure that all dependencies are correctly installed.
4. Connection issues
   • If the client fails to connect to the server, check the network configuration and port settings.

Get Help

If you encounter any problems, please refer to the project documentation or submit an issue on the GitHub repository: https://github.com/yourusername/jay-py-mcp-sse