MCP 服务开发与使用说明

本项目包含 3 个基于 Python 的自定义 MCP（Model Context Protocol）服务，可在 Cherry Studio、Cursor 等支持 MCP 的 AI 客户端中使用，实现工具调用、功能扩展。

项目结构

D:\lianxi\mcp\
├── test.py           # 桌面文件查看 + 计算器工具服务
├── food_mcp.py       # 「今天吃什么」随机推荐服务
└── README.md         # 项目说明文档

环境准备

1. 依赖安装

# 激活虚拟环境（已配置 MCP 虚拟环境）
conda activate MCP
# 安装 MCP 核心依赖
pip install mcp "mcp[cli]"

2. 环境验证

终端执行以下命令，无报错即环境配置完成：

python --version  # 需 ≥ Python 3.13
pip list | grep mcp  # 确认 mcp 依赖已安装

服务说明

1. test.py - 基础工具服务

功能列表

本地启动测试

cd D:\lianxi\mcp
python test.py

正常运行标志：终端无任何输出，光标持续闪烁。

2. food_mcp.py - 「今天吃什么」服务

功能列表

本地启动测试

cd D:\lianxi\mcp
python food_mcp.py

使用 mcp dev调试服务

mcp dev是 MCP 官方提供的调试工具，能让你在浏览器中可视化查看工具列表、发送请求、查看日志，非常方便开发调试。

1. 启动调试服务

# 进入项目目录
cd D:\lianxi\mcp
# 调试 test.py 服务
mcp dev test.py
# 或调试 food_mcp.py 服务
mcp dev food_mcp.py

2. 打开调试界面

运行命令后，终端会输出类似以下信息：

Starting MCP inspector at http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=xxx

复制这个地址，在浏览器中打开，即可进入 MCP Inspector 调试界面

3. 调试界面使用说明

在界面中，你可以：

1. 查看工具列表：自动加载服务里所有的 @mcp.tool() 工具
2. 手动调用工具：输入参数，点击调用，直接看返回结果
3. 查看请求日志：实时查看服务收到的请求和响应，快速定位问题

Cursor 客户端配置

1. 打开配置文件

点击右上角设置然后选择Tools&MCPs，点击Add Custom MCP后，会看到一个mcp.json的文件，配置相应的mcp服务

2. 完整配置

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@amap/amap-maps-mcp-server"
      ],
      "env": {
        "AMAP_MAPS_API_KEY": "3ca167595ea64e600468c109b88db82a"
      }
    },
    "food-mcp": {
      "command": "C:\\Users\\A\\.conda\\envs\\MCP\\python.exe",
      "args": ["D:\\lianxi\\mcp\\food_mcp.py"]
    },
    "test": {
      "command": "C:\\Users\\A\\.conda\\envs\\MCP\\python.exe",
      "args": ["D:\\lianxi\\mcp\\test.py"]
    }
  }
}

3. 验证服务状态

1. 保存 mcp.json 文件
2. 进入 Settings → Tools & MCPs
3. 三个服务均显示绿色圆点，代表连接成功

客户端调用示例

在 Cursor 的 AI 对话面板中，直接使用自然语言调用工具：

• 帮我列出桌面文件
• 计算 123 × 456
• 今天吃什么？
• 推荐一个川菜做法简单的菜

常见问题排查

1. 服务显示红色 Error

• 文件路径错误：检查 mcp.json 中的文件路径，Windows 需用 \\ 分隔目录
• 文件为空 / 无代码：确认 test.py / food_mcp.py 中包含完整代码
• 依赖未安装：在虚拟环境中重新执行 pip install mcp "mcp[cli]"
• 终端报错：点击 Error - Show Output 查看日志，定位具体错误原因

2. 工具调用无响应

• 确认服务已启动，无 print() 等控制台输出（会破坏 stdio 通信）
• 保存 mcp.json 后，关闭并重新打开服务开关，刷新配置