Cursor Model Context Protocol (MCP) Example

Cursor 模型上下文协议（MCP）示例

此存储库包含模型上下文协议（MCP）服务的示例实现，可与 Cursor IDE 配合使用，通过自定义工具和数据源增强 AI 能力。

什么是模型上下文协议？

模型上下文协议（MCP）是一种开放协议，用于规范应用程序向大语言模型（LLM）提供上下文的方式。它允许你创建可供 Cursor 中的 AI 助手使用的自定义工具。

可以把 MCP 想象成 AI 应用的 USB-C 接口：

• 就像 USB-C 提供了一种连接设备与各种外围设备的标准方式，MCP 也提供了一种将 AI 模型连接到不同数据源和工具的标准方式
• 它使 AI 助手能够访问实时信息、执行专用功能，并在训练数据的基础上增强自身能力

项目结构

example-mcp/
├── mcp-servers/                # Different MCP server implementations
│   ├── task-manager/           # Task manager MCP server example
│   ├── file-explorer/          # File explorer MCP server example
│   └── weather-service/        # Weather service MCP server example
├── client-examples/            # Example code for testing MCP servers
├── docs/                       # Additional documentation
└── README.md                   # This file

MCP 服务示例

此存储库包含多个 MCP 服务示例：

1. 任务管理器 MCP 服务

一个用于管理任务的简单 MCP 服务：

• 创建新任务
• 列出所有任务
• 将任务标记为已完成
• 删除任务

2. 文件浏览器 MCP 服务

一个支持浏览和操作文件的 MCP 服务：

• 列出目录中的文件
• 读取文件内容
• 创建新文件
• 删除文件

3. 天气服务 MCP 服务

一个提供天气信息的 MCP 服务：

• 获取某个位置的当前天气
• 获取某个位置的天气预报
• 获取历史天气数据

开始使用

前置条件

• Node.js（v14 或更高版本）
• Cursor IDE

设置 MCP 服务

1. 进入其中一个服务目录：

   cd example-mcp/mcp-servers/task-manager
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   npm start
   

连接到 Cursor

要将 MCP 服务连接到 Cursor：

1. 打开 Cursor IDE
2. 前往 Settings（左下角的齿轮图标）
3. 导航至“Features”部分
4. 向下滚动到“MCP”
5. 点击“Add New MCP Server”
6. 为服务输入名称（例如，“Task Manager MCP”）
7. 选择传输类型：
   • SSE：输入 MCP 服务的 URL（例如，http://localhost:3000）
   • Stdio：输入启动服务的命令（例如，node /path/to/example-mcp/mcp-servers/task-manager/index.js）
8. 点击“Add”

在 Cursor 中使用 MCP 工具

连接 MCP 服务后，你可以在 Cursor 的 AI 功能中使用它：

1. 打开 AI 聊天面板（Cmd+I 或 Ctrl+I）

2. 让 AI 使用你的 MCP 工具：

   Please create a new task titled "Implement user authentication" with the description "Add user login and registration functionality to the application."
   

3. AI 将使用你的 MCP 服务创建任务，并返回结果

4. 你也可以请求列出任务：

   Show me all the current tasks in the task manager.
   

MCP 架构

模型上下文协议采用客户端-服务端架构：

• MCP 主机：希望通过 MCP 访问数据的程序，例如 Cursor IDE
• MCP 客户端：与服务保持连接的协议客户端
• MCP 服务：通过标准化模型上下文协议公开特定功能的轻量级程序
• 本地数据源：你的计算机中的文件、数据库和服务，MCP 服务可以安全地访问这些内容
• 远程服务：可通过互联网访问、且 MCP 服务可以连接的外部系统

传输方式

MCP 支持多种传输机制：

1. Stdio 传输：

   • 使用标准输入/输出进行通信
   • 适用于本地进程

2. 带 SSE 的 HTTP 传输：

   • 使用服务器发送事件传递从服务端到客户端的消息
   • 使用 HTTP POST 传递从客户端到服务端的消息

所有传输方式均使用 JSON-RPC 2.0 交换消息。

创建你自己的 MCP 服务

要创建你自己的 MCP 服务：

1. 为你的服务创建一个新目录

2. 初始化 Node.js 项目：

   npm init -y
   

3. 安装所需的依赖项：

   npm install @modelcontextprotocol/server express
   

4. 创建一个 index.js 文件并编写服务实现

5. 注册工具，并为其指定名称、描述和参数架构

6. 为每个工具实现处理程序

7. 设置 Express 服务并应用 MCP 中间件

请参阅此代码库中的示例服务，了解参考实现。

故障排除

如果你的 MCP 服务遇到问题：

1. 检查服务日志，查看是否有错误
2. 确认服务正在运行，且可通过指定的 URL 访问
3. 如果连接状态没有更新，重启 Cursor
4. 检查 Cursor 的日志，查看是否有连接错误（帮助 > 切换开发者工具）

资源

• Model Context Protocol 文档
• Cursor MCP 文档
• MCP GitHub 代码库

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。