更详细的 Cursor 配置 MCP 教程请查看 Cursor 官方文档
配置步骤
这边我简单展示一个最基础的配置方式,确保你已经创建了相关的目录和文件:1
创建配置目录
2
配置 MCP Server
在
.cursor/mcp.json 中添加以下配置,这里我们直接用自己的模拟用户服务来试:3
启用 MCP Server
- 打开 Cursor 设置
- 在 MCP 栏里启用这个 MCP Server
- 启用之后你会看到它变成一个小绿点
- 同时还会列出可用的 Tools
配置验证
配置完成后,可以在 Cursor 的设置界面中看到:连接状态
绿色圆点表示 MCP Server 连接正常
可用工具
界面会显示从 MCP Gateway 获取的可用工具列表
使用示例
最后就可以在 Chat 窗口里试一下,比如让它帮你注册一个用户,然后再查询这个用户的信息,跑通就 OK 了。示例对话
通过实际测试发现,这个 mock 服务因为涉及名字邮箱,可能在某些情况下引发模型错误导致无法调用,可忽略这种情况,配置实际的 API 使用即可。
常见问题
连接失败
连接失败
- 确保 MCP Gateway 服务正在运行
- 检查端口 5235 是否可访问
- 验证 URL 配置是否正确
工具无法使用
工具无法使用
- 检查 MCP Server 配置是否正确加载
- 验证工具权限配置
- 查看 MCP Gateway 日志了解详细错误信息
配置更新不生效
配置更新不生效
- 重启 Cursor
- 重新加载 MCP 配置
- 检查配置文件格式是否正确
高级配置
对于更复杂的使用场景,可以配置多个 MCP Server:每个 MCP Server 对应一个业务域,这样可以更好地组织和管理不同的功能模块。