MCP实战指南（二）：5分钟搭建Python开发环境——从SDK安装到调试工具链配置

1. 基础环境搭建

1.1 Python环境配置（新手必看）

• 推荐使用Python 3.10+（MCP对异步语法有依赖）
• 高效依赖管理工具选型：

  # 传统pip（兼容性好）
  python -m pip install --upgrade pip
  
  # 推荐使用uv（速度提升10倍+）
  curl -LsSf https://astral.sh/uv/install.sh | sh
  uv pip install -r requirements.txt
  

1.2 安装Simple-MCP-Server-with-Python

# 克隆仓库并安装依赖
git clone https://github.com/ruslanmv/Simple-MCP-Server-with-Python
cd Simple-MCP-Server-with-Python
uv pip install -r requirements.txt  # 或用传统pip

• 常见问题排查：
  • 报错ImportError: cannot import name 'MCPServer' → 检查是否在项目根目录运行
  • Windows用户需确保已安装build-essential（可通过winget install GCC安装）

2. 开发工具链配置

2.1 MCP Inspector调试神器

• 功能：实时监控MCP协议通信报文，可视化工具注册/调用过程
• 启动方式（需先安装Node.js）：

  npx mcp-inspector --port 3333
  

  • 访问http://localhost:3333查看交互流程图

2.2 客户端配置（以Cursor为例）

1. 在Cursor设置中开启Experimental Features
2. 创建mcp.json配置文件：

   {
     "mcpServers": {
       "my_python_tools": {
         "command": "python",
         "args": ["/path/to/your/server.py"],
         "env": {"DEBUG": "true"}
       }
     }
   }
   

3. 重启Cursor后输入/mcp list查看已注册工具

3. 验证开发环境（实战检测）

步骤1：创建测试Server

# test_server.py
from simple_mcp_server import MCPServer
mcp = MCPServer("TestTools")

@mcp.tool()
def ping() -> str:
    """测试服务连通性"""
    return "pong"

mcp.run()

步骤2：双端验证

• 服务端：启动后应输出：

  [INFO] Tool registered: ping (description: 测试服务连通性)
  [INFO] MCP server started on stdio
  

• 客户端：在Cursor中输入：

  @ping   # 触发工具调用
  

  应收到回复：pong

4. 进阶技巧：热重载开发模式

通过uvicorn实现代码修改自动重启：

uvicorn server:app --reload --port 8000

配置mcp.json改用HTTP模式：

"args": ["--sse", "--port", "8000"]

---

附录：常用命令速查表

功能	命令
安装SDK依赖	uv pip install -r requirements.txt
启动Inspector	npx mcp-inspector --port 3333
测试工具连通性	curl -X POST http://localhost:8000/mcp -d '{"tool":"ping"}'