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. 创建具有以下权限的新细粒度令牌：

- 存储库：读写（管理、内容、问题、拉取请求） - 用户：只读

1. 安全地保存您的令牌-您需要它进行配置

步骤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

资源

• 模型上下文协议（MCP）文档

______________________________________________________________________

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