MCP Server Python

🚀 MCP 服务器演示（Python 版）

本项目提供了一个简单的 Model Communication Protocol (MCP) 服务器的 Python 实现。它能展示 MCP 服务器的基本功能，可用于测试和开发。服务器默认借助 uvicorn 运行，监听端口为 8000。若要将服务器暴露到网络中，需使用 sse 传输。

🚀 快速开始

安装依赖

创建并激活虚拟环境，运行以下命令来设置 Python 环境：

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

启动服务器

python3 server.py

验证服务器是否在运行

你可以使用以下命令验证服务器是否在端口 8000 上运行：

• 检查活动连接：

  netstat -n | grep 8000
  

• 检查占用端口的进程：

  lsof -i :8000
  

• 使用 curl 测试服务器：

  curl http://0.0.0.0:8000/sse
  

📦 安装指南

创建并激活虚拟环境

运行以下命令来设置 Python 环境：

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

💻 使用示例

与工具集成

要将此服务器与工具（如 Cursor 或 Claude）集成，请使用以下 mcp.json 配置文件：

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

📚 详细文档

运行测试

该项目包含一个全面的测试套件，使用 pytest。要运行测试：

# 安装测试依赖项
pip install -r requirements.txt

# 以详细输出运行测试
pytest -v

# 生成覆盖率报告运行测试
pytest --cov=.

测试范围

测试套件包括以下内容：

• 基本功能测试（加法和减法）
• 输入验证和类型检查
• 大数边界情况
• API 端点测试（问候语）

所有测试均位于 test_server.py 中，并涵盖：

• add() 函数
• subtract() 函数
• get_greeting() 函数
• 类型错误处理
• 边界情况处理

⚠️ 注意事项

⚠️ 重要提示

• 默认情况下，服务器使用 stdio 传输。要将其暴露到网络中，请确保配置为使用 sse 传输。
• 该服务器运行在 localhost 上，并监听端口 8000 使用 uvicorn。

如有任何问题，请随时贡献或提出问题！