GitHub MCP服务器

GitHub MCP服务器是一个用于AI辅助开发工作流程的工具,通过标准化接口使AI助手能够与GitHub进行交互,执行仓库管理、文件操作、问题处理等任务。

  • by sonadukane18
  • 本地部署
  • 更新于
在 GitHub 查看 sonadukane18/experimental-mcp-server-created-by-github-mcp

使用说明

GitHub MCP服务器设置指南

此存储库演示了如何为AI辅助开发工作流设置和使用GitHub模型上下文协议(MCP)服务器。

什么是MCP?

模型上下文协议(MCP)使AI助手能够通过标准化的接口与外部系统和API进行交互。GitHub MCP服务器专门允许AI模型执行GitHub操作,例如:

  • 创建/管理存储库
  • 管理文件和内容
  • 处理问题和拉取请求
  • 访问存储库信息
  • 还有更多!

安装说明

先决条件

  • 系统上已安装Node.js
  • GitHub帐户
  • 具有适当权限的GitHub个人访问令牌(PAT)

步骤1:创建GitHub个人访问令牌

  1. 转到GitHub设置→ 开发人员设置→ 个人访问令牌
  2. 创建具有以下权限的新细粒度令牌:
    • 存储库:读写(管理、内容、问题、拉取请求)
    • 用户:只读
  3. 安全地保存您的令牌-您需要它进行配置

步骤2:设置MCP配置

  1. 创建名为的配置文件 mcp.json 在您的用户目录中(例如。, ~/.cursor/mcp.json 或 C:\Users\YourUsername\.cursor\mcp.json)
  2. 添加以下配置:
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat_here"
      }
    }
  }
}
  1. 替换 your_github_pat_here 使用您的实际GitHub个人访问令牌

步骤3:测试您的MCP服务器

  1. 安装支持MCP的兼容AI编码助手(如Cursor)
  2. 让助手执行GitHub操作,例如:
    • 创建存储库
    • 正在获取文件内容
    • 制造问题
    • 发出pull请求

使用示例

以下是您可以使用GitHub MCP执行的一些操作示例:

  • 创建新存储库: Create a new GitHub repository named "my-project"
  • 将代码推送到存储库: Push this file to my repository
  • 创建问题: Create an issue titled "Fix navigation bug" in my repository
  • 获取存储库内容: Show me the contents of the main.js file from my repository

故障排除

  • 权限错误:确保您的GitHub PAT具有您尝试执行的操作所需的权限
  • 连接问题:检查您的MCP服务器是否已正确配置并正在运行
  • 令牌到期:GitHub PAT可能会过期-检查是否需要生成新的PAT

资源


注意:始终保持GitHub个人访问令牌的安全,永远不要将其提交到公共存储库。