Example MCP

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

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

什么是模型上下文协议？

模型上下文协议（MCP）是一个开放协议，它规范了应用程序如何向大型语言模型（LLM）提供上下文。它允许您在Cursor中创建AI助手可以使用的自定义工具。

将MCP视为AI应用程序的USB-C端口：

• 正如USB-C提供了一种将设备连接到各种外围设备的标准化方式一样，MCP提供了一个将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服务器：

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

入门指南

先决条件

• （v14或更高版本）
• 光标IDE

设置MCP服务器

1. 导航到以下服务器目录之一：

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

1. 安装依赖项：

   npm install

1. 启动服务器：

   npm start

连接到游标

要将MCP服务器连接到Cursor，请执行以下操作：

1. 打开光标IDE
2. 转到设置（左下角的齿轮图标）
3. 导航到“功能”部分
4. 向下滚动到“MCP”
5. 点击“添加新MCP服务器”
6. 输入服务器的名称（例如“任务管理器MCP”）
7. 选择运输类型：

- SSE：输入您的MCP服务器的URL（例如。， http://localhost:3000) - 标准输入输出：输入启动服务器的命令（例如。， node /path/to/example-mcp/mcp-servers/task-manager/index.js)

1. 点击“添加”

在游标中使用MCP工具

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

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

1. 让AI使用您的MCP工具：

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

1. AI将使用您的MCP服务器创建任务并返回结果

1. 您还可以要求提供任务列表：

   Show me all the current tasks in the task manager.

MCP架构

模型上下文协议遵循客户端-服务器架构：

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

运输

MCP支持多种传输机制：

1. 标准运输:

- 使用标准输入/输出进行通信 - 非常适合本地流程

1. HTTP与SSE传输:

- 对服务器到客户端的消息使用服务器发送事件 - 客户端到服务器消息的HTTP POST

所有传输都使用JSON-RPC 2.0来交换消息。

创建自己的MCP服务器

要创建自己的MCP服务器：

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

1. 初始化Node.js项目：

   npm init -y

1. 安装所需的依赖项：

   npm install @modelcontextprotocol/server express

1. 使用服务器实现创建一个index.js文件

1. 使用名称、描述和参数模式注册工具

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

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

有关参考实现，请参阅此存储库中的示例服务器。

故障排除

如果您的MCP服务器遇到问题：

1. 检查服务器日志 对于任何错误
2. 验证服务器是否正在运行 并可在指定的URL访问
3. 重新启动游标 如果连接状态不更新
4. 检查Cursor的日志 对于任何连接错误（帮助>切换开发人员工具）

资源

• 模型上下文协议文档
• 光标MCP文档

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。