Understanding MCP (Model Context Protocol) and GitHub Integration

了解 MCP（Model Context Protocol）与 GitHub 集成

什么是 MCP？

Model Context Protocol（MCP）是一种革命性的标准化协议，可让 AI Agent 与各种工具和服务无缝通信。可以把它想象成一种通用翻译器：

• 没有 MCP：每种工具都使用自己的语言，因此 AI Agent 很难集成多个工具。
• 有了 MCP：所有工具都使用相同的语言，从而轻松实现集成和通信。

现实生活中的类比

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

• 没有 MCP：你需要十位不同的翻译
• 有了 MCP：所有人都使用共同的语言，协作变得轻而易举

这种标准化让 AI Agent 可以：

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

GitHub MCP 功能

GitHub MCP 集成提供了强大的功能，可用于与 GitHub 仓库交互：

仓库管理

• 创建新仓库
• 派生现有仓库
• 克隆仓库
• 管理分支
• 创建和合并拉取请求

代码操作

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

问题管理

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

协作功能

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

安装指南

前置条件：Node.js 设置

1. 访问 Node.js 网站
2. 下载相应版本：
   • 对于 M1/M2 Mac：macOS ARM64
   • 对于 Intel Mac：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：命令行安装

# Using 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. 处理问题和拉取请求
3. 搜索代码
4. 管理文件和分支
5. 与团队成员协作