GitHub集成协议

Model Context Protocol (MCP) 是一种革命性的标准化协议,使AI代理能够无缝与各种工具和服务通信,特别是与GitHub的集成,提供仓库管理、代码操作、问题管理和协作功能。

  • by md-anbari
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 md-anbari/cursor-mcp-guide

使用说明

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

什么是MCP?

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

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

现实世界类比

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

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

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

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

GitHub MCP功能

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

库管理

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

代码操作

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

问题管理

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

协作功能

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

安装指南

先决条件:Node.js设置

  1. 访问 Node.js网站
  2. 下载相应版本:
    • 适用于M1/M2 Mac:macOS ARM64
    • 适用于英特尔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. 访问 史密瑟里
  2. 浏览可用的MCP服务器:
    • 按类别筛选
    • 按受欢迎程度排序
    • 按名称或功能搜索
  3. 从列表中选择“GitHub MCP”
  4. 遵循安装说明

添加到光标

方法1:命令行安装

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

方法2:手动配置

  1. 打开光标设置:

    • 使用 ⌘ + Shift + P (macOS)或 Ctrl + Shift + P (Windows)
    • 键入“光标设置”
    • 选择“MCP”
  2. 添加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. 与团队成员协作