理解 MCP (模型上下文协议) 和 GitHub 集成

什么是 MCP？

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

• 没有 MCP: 每个工具都使用自己的语言，这使得 AI 代理很难与多个工具集成。
• 有了 MCP: 所有工具都使用相同的语言，从而可以轻松集成和通信。

现实世界的类比

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

• 没有 MCP: 你需要十个不同的翻译
• 有了 MCP: 每个人都说一种通用语言，从而使协作变得毫不费力

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

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

GitHub MCP 功能

GitHub MCP 集成提供了强大的功能，用于与 GitHub 存储库进行交互：

存储库管理

• 创建新的存储库
• Fork 现有的存储库
• 克隆存储库
• 管理分支
• 创建和合并 pull requests

代码操作

• 搜索代码
• 创建和编辑文件
• 提交更改
• 审查 pull requests
• 添加评论和审查

问题管理

• 创建和更新 issues
• 向 issues 添加评论
• 搜索 issues
• 应用标签和分配人员
• 跟踪里程碑

协作功能

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

安装指南

前提条件：Node.js 设置

1. 访问 Node.js website
2. 下载合适的版本：
   • 对于 M1/M2 Macs: macOS ARM64
   • 对于 Intel Macs: macOS x64
3. 运行安装程序并按照提示操作

安装 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. 访问 Smithery
2. 浏览可用的 MCP 服务器：
   • 按类别过滤
   • 按受欢迎程度排序
   • 按名称或功能搜索
3. 从列表中选择 "GitHub MCP"
4. 按照安装说明进行操作

添加到 Cursor

方法 1：命令行安装

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

方法 2：手动配置

1. 打开 Cursor 设置：

   • 使用 ⌘ + Shift + P (macOS) 或 Ctrl + Shift + P (Windows)
   • 输入 "Cursor Settings"
   • 选择 "MCP"

2. 添加 MCP 服务器：

   • 点击 "Add new global MCP server"
   • 使用提供的 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. 处理 issues 和 pull requests
3. 搜索代码
4. 管理文件和分支
5. 与团队成员协作