Cursor MCP Guide

了解MCP（模型上下文协议）和GitHub集成

什么是MCP？

模型上下文协议（MCP）是一种革命性的标准化协议，使AI代理能够与各种工具和服务无缝通信。把它想象成一个通用的翻译器：

• 无MCP每个工具都有自己的语言，这使得AI代理很难与多个工具集成。
• 使用MCP：所有工具都使用相同的语言，便于集成和交流。

现实世界类比

想象一下，有十位专家顾问，每人说一种不同的语言：

• 没有MCP：你需要十个不同的翻译
• 使用MCP：每个人都会说一种共同的语言，使协作变得轻松

这种标准化使AI代理能够：

• 连接到数据库
• 与GitHub互动
• 访问云服务
• 管理文件和文档
• 还有更多！

GitHub MCP功能

GitHub MCP集成提供了与GitHub存储库交互的强大功能：

库管理

• 创建新存储库
• 分叉现有存储库
• 克隆存储库
• 管理分支
• 创建和合并拉取请求

代码操作

• 通过代码搜索
• 创建和编辑文件
• 提交更改
• 审查拉取请求
• 添加评论和评论

问题管理

• 创建和更新问题
• 为问题添加评论
• 搜索问题
• 应用标签和指定人员
• 跟踪里程碑

协作功能

• 管理项目板
• 处理讨论
• 评审意见
• 管理存储库设置
• 控制访问权限

安装指南

先决条件：Node.js设置

1. 访问
2. 下载相应版本：

- 适用于M1/M2 Mac：macOS ARM64 - 适用于英特尔Mac：macOS x64

1. 运行安装程序并按照提示操作

安装GitHub MCP

方法1：使用Smithery CLI（推荐）

npx -y @smithery/cli@latest install @smithery-ai/github \
  --client cursor \
  --config '{"githubPersonalAccessToken":"your_token_here"}'

方法2：手动配置

1. 打开 ~/.cursor/mcp.json
2. 添加以下配置：

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

在Smithery上查找MCP服务器

1. 访问 史密瑟里
2. 浏览可用的MCP服务器：

- 按类别筛选 - 按受欢迎程度排序 - 按名称或功能搜索

1. 从列表中选择“GitHub MCP”
2. 遵循安装说明

添加到光标

方法1：命令行安装

# Using Smithery CLI
npx @smithery/cli install @smithery-ai/github

方法2：手动配置

1. 打开光标设置：

- 使用 ⌘ + Shift + P （macOS）或 Ctrl + Shift + P （Windows） - 键入“光标设置” - 选择“MCP”

1. 添加MCP服务器：

- 点击“添加新的全局MCP服务器” - 使用提供的JSON结构进行配置

方法3：直接JSON配置

1. 引导到 ~/.cursor/mcp.json
2. 手动添加服务器配置：

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

使用GitHub MCP

安装后，您可以使用GitHub MCP：

1. 创建和管理存储库
2. 处理问题并拉取请求
3. 通过代码搜索
4. 管理文件和分支
5. 与团队成员协作