py-mcp-sse

View on GitHub

MCP Client 与 MCP Server基于SSE方式的样例实现（Python版本）

9 stars PythonDeveloper Kits Updated Sep 8, 2025

Documentation

本项目建于2025-03-30，是一个MCP Client 与 MCP Server的样例实现（Python版本）

它是以https://github.com/sidharthrajaram/mcp-sse为基础优化实现的【原项目上是基于(https://github.com/modelcontextprotocol/python-sdk/issues/145)的原始讨论，可下载原项目有更多说明】。

原版本是使用ANTHROPIC LLM实现，本版本调整使用OpenRouter.ai的LLM中转调用平台实现。

基于SSE的 MCP 服务器和客户端

`mcp_server.py` 是一个基于SSE的MCP服务器，提供了基于古腾堡计划API的图书搜索工具。改编自MCP文

档中的示例STDIO服务器实现。

`client.py` 是一个MCP客户端，可以连接并使用基于SSE的MCP服务器提供的工具。改编自MCP文档中的示例STDIO客户端实现。

系统要求

Python 3.13 或更高版本
uv包管理器（推荐）或pip

安装步骤

1. 克隆项目

bash

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

2. 环境配置

使用uv（推荐）：

bash

# 安装uv（如果未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境并安装依赖
uv venv
uv pip install .

或使用传统pip：

bash

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/MacOS
# 或
.venv\Scripts\activate  # Windows

# 安装依赖
pip install .

3. 配置环境变量

复制环境变量示例文件并填写必要信息：

bash

cp .env.sample .env

编辑 `.env` 文件，填入你的 OpenRouter API 密钥：

plaintext

OPENROUTER_API_KEY=your_api_key_here

运行服务

1. 启动服务器

bash

uv run mcp_server.py
# 或指定主机和端口
uv run mcp_server.py --host 127.0.0.1 --port 8080

2. 启动客户端

bash

uv run client.py http://localhost:8080/sse

示例输出

code

已初始化SSE客户端...
正在列出工具...

已连接到服务器，可用工具：['search_gutenberg_books']

AI助手已启动！
输入您的问题或输入'quit'退出。

用户: 请推荐一些詹姆斯·乔伊斯的作品

AI: 让我帮您搜索詹姆斯·乔伊斯的作品...
[调用工具 search_gutenberg_books，参数：{"search_terms": ["James Joyce"]}]

找到以下作品：
- 《尤利西斯》(Ulysses)
- 《都柏林人》(Dubliners)
- 《青年艺术家的画像》(A Portrait of the Artist as a Young Man)
...

项目结构

code

.
├── mcp_server.py    # SSE服务器实现
├── client.py        # MCP客户端实现
├── .env.sample      # 环境变量示例
├── pyproject.toml   # 项目依赖和配置管理
└── README.md        # 项目文档

为什么选择这种方式？

这种实现方式意味着MCP服务器现在可以作为一个运行中的进程，代理（客户端）可以随时随地连接、使用并断开连接。换句话说，基于SSE的服务器和客户端可以是解耦的进程（甚至可以在解耦的节点上运行）。这与基于STDIO的模式不同，在STDIO模式中客户端本身会将服务器作为子进程启动。这种方式更适合"云原生"用例。

故障排除

如果遇到问题，请检查：

1. Python版本是否满足要求（>=3.13）

2. 环境变量是否正确配置

3. 所有依赖是否正确安装

4. 端口8080是否被占用（如被占用，可使用--port参数指定其他端口）

获取帮助

如果遇到问题，请：

1. 检查项目的GitHub Issues页面

2. 提供完整的错误信息和运行环境信息

3. 描述问题重现步骤

Frequently asked questions

What is py-mcp-sse?

py-mcp-sse is MCP Client 与 MCP Server基于SSE方式的样例实现（Python版本）

How do I install py-mcp-sse?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is py-mcp-sse open source?

Yes — it is hosted on GitHub at https://github.com/jayliangdl/py-mcp-sse and has 9 stars.

Related MCP tools

mcp

AWS MCP Servers — helping you get the most out of AWS, wherever you use MCP. Python-based implementation. Trusted by 6900+ developers.

6,922 Python

awsmcpmcp-client+6

mcpo

A simple, secure MCP-to-OpenAPI proxy server Python-based implementation. Trusted by 3500+ developers. Trusted by 3500+ developers.

3,594 Python

mcpmcp-servermcp-to-openapi+2

mcp-obsidian

MCP server that interacts with Obsidian via the Obsidian rest API community plugin Python-based implementation. Trusted by 2300+ developers.

2,353 Python

mcp-cli

Default Configuration: MCP CLI defaults to using Ollama with the gpt-oss reasoning model for local, privacy-focused operation without requiring API keys.

1,747 Python

minimax-mcp

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

1,032 Python

image-generationimage-to-videomcp+7

mcp-mem0

MCP server for long term agent memory with Mem0. Also useful as a template to get you started building your own MCP server with Python!

592 Python

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP