指南：配置 GitHub MCP Server 认证

GitHub MCP Server 让 AI Agent 能够安全地操作 GitHub 仓库。本文详细讲解配置方法和安全最佳实践。

什么是 GitHub MCP Server？

GitHub MCP Server 提供以下能力：

• 读取仓库代码
• 创建和管理 Issues
• 创建和管理 Pull Requests
• 搜索代码
• 管理分支

创建 Personal Access Token

步骤 1：访问 GitHub 设置

1. 登录 GitHub
2. 点击右上角头像 → Settings
3. 左侧菜单 → Developer settings
4. Personal access tokens → Tokens (classic)
5. 点击 Generate new token

步骤 2：配置 Token

Token 名称

Claude-Code-MCP

有效期

• 推荐：90 天（安全性更高）
• 可选：No expiration（需定期轮换）

权限范围（Scopes）

权限	说明	推荐
repo	完全控制私有仓库	✅ 必须
repo:status	访问提交状态	✅ 推荐
repo_deployment	访问部署状态	可选
public_repo	访问公开仓库	✅ 推荐
read:org	读取组织信息	可选
read:user	读取用户信息	可选
read:discussion	读取讨论	可选

最小权限推荐

repo, repo:status, public_repo

步骤 3：保存 Token

重要：Token 只显示一次，务必保存！

ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Claude Code 配置

配置方式

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

环境变量方式（推荐）

方式 1：配置文件中使用环境变量

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

方式 2：系统环境变量

# 添加到 ~/.zshrc 或 ~/.bashrc
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 配置文件引用
"env": {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "" + process.env.GITHUB_TOKEN + ""
}

安全最佳实践

1. 最小权限原则

只授予必要的权限：

• 如果只需要读取代码：只选 public_repo
• 如果需要操作 Issues/PRs：选 repo
• 不需要的权限不要勾选

2. Token 轮换

定期更换 Token：

• 设置提醒（如每 90 天）
• 创建新 Token → 更新配置 → 删除旧 Token

3. 监控 Token 使用

查看 Token 使用记录：

GitHub Settings → Developer settings → Personal access tokens
→ 点击 Token 名称查看 Last used

4. 安全存储

不要：

• ❌ 将 Token 提交到代码仓库
• ❌ 在日志中打印 Token
• ❌ 分享给他人

应该：

• ✅ 使用环境变量
• ✅ 配置文件添加到 .gitignore
• ✅ 使用密码管理器存储

验证配置

1. 重启 Claude Code
2. 输入 /mcp 查看 github 工具
3. 测试查询：

   请查看我的 GitHub 仓库列表
   

常见问题

Q: Token 过期了怎么办？

解决：

1. 在 GitHub 创建新 Token
2. 更新 claude_desktop_config.json
3. 重启 Claude Code

Q: 如何撤销 Token？

解决：

GitHub Settings → Developer settings → Personal access tokens
→ 点击 Delete 删除 Token

Q: 可以限制 Token 访问的仓库吗？

目前不可以。GitHub Classic Token 是全局的。如需限制，使用 Fine-grained Token（实验性功能）。

下一步

• Unauthorized 错误排查
• 创建 Pull Request 指南
• 文件系统工具配置