Python与MCP的集成使用指南

一、环境搭建

1. 安装依赖

2. Python环境：需Python 3.10+，推荐使用虚拟环境（如venv或conda）。

   python -m venv mcp-env
   source mcp-env/bin/activate  Linux/Mac
   pip install mcp fastapi uvicorn  安装SDK及Web框架
   

3. Node.js环境（可选）：用于开发JavaScript服务器。

   npm install @modelcontextprotocol/sdk
   

4. 客户端工具

5. 支持MCP的AI应用：如Claude Desktop、Cursor、Cline（VS Code插件）等，需确保版本支持MCP协议。

二、服务器开发

1. Python示例（基础工具开发）

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("天气查询服务")
@mcp.tool()
def get_weather(city: str) -> str:
    """获取指定城市的天气信息"""
    实际开发中需调用天气API（此处模拟数据）
    return f"{city}今日晴，28℃"
if __name__ == "__main__":
    mcp.run(transport="stdio")  本地调试模式

2. Node.js示例（数据库集成）

import { Server } from "@modelcontextprotocol/sdk/server";
const server = new Server({
  name: "MongoDB查询服务",
  version: "1.0.0"
});
server.defineTool({
  name: "query_orders",
  description: "查询订单数据",
  inputSchema: { type: "object", properties: { status: { type: "string" } } },
  handler: async (args) => {
    // 连接MongoDB并执行查询
    return { results: ["订单1", "订单2"] };
  }
});
server.start();

三、客户端配置

1. Cursor配置

2. 打开Cursor的Settings > MCP Servers，添加服务器配置：

   {
     "mcpServers": {
       "weather": {
         "command": "python",
         "args": ["weather_server.py"]
       }
     }
   }
   

3. 重启后，在对话框输入“北京天气如何？”即可触发工具调用。

4. VS Code Cline插件配置

5. 安装Cline扩展，进入Settings > MCP Servers，添加Node.js服务器：

   {
     "mcpServers": {
       "github": {
         "command": "node",
         "args": ["github_mcp_server.js"]
       }
     }
   }
   

四、实际应用场景

1. 数据库查询

2. 文件系统操作

@mcp.tool()
def list_desktop_files() -> list:
    """获取桌面文件列表"""
    return os.listdir(os.path.expanduser("~/Desktop"))

五、常见问题与优化

1. Windows路径问题

2. 使用全路径启动服务，避免npx路径冲突：

   node C:\path\to\server.js
   

3. 性能优化

4. 多进程部署：

   uvicorn main:app --workers 4 --port 8000
   

5. 安全增强

6. 添加JWT认证或白名单机制，限制敏感操作权限。

六、扩展生态

作者：爪哇手记