AI导哈

GitHub集成服务

通过Docker配置的MCP服务器实现GitHub集成，提供仓库、问题、PR等管理功能。

  • by BibinBenJose
  • 本地部署
  • 更新于
在 GitHub 查看 BibinBenJose/MCP

使用说明

MCP服务器配置

此存储库包含用于与Windsurf IDE配合使用的模型上下文协议（MCP）服务器的配置。

什么是MCP？

模型上下文协议（MCP）是一种标准，用于将人工智能系统与外部工具和数据源相连接。MCP服务器通过提供访问专用功能、外部信息和服务，扩展了人工智能的能力。

当前配置

GitHub MCP 服务器

此配置通过基于Docker的MCP服务器实现了与GitHub的集成。

位置： ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN_HERE",
        "ghcr.io/github/github-mcp-server"
      ]
    }
  }
}

设置说明

先决条件

  1. **Docker（注：Docker是一个开源的应用容器引擎，用于开发、交付和运行应用程序。在此处直接作为专有名词翻译，不作额外解释。）**确保已安装并运行Docker

    docker --version

  2. GitHub 个人访问令牌生成一个具有适当权限的令牌

    • 前往 GitHub → 设置 → 开发者设置 → 个人访问令牌
    • 生成一个带有所需范围（如 repo、read:org 等）的新令牌

安装步骤

  1. 创建配置文件：

    mkdir -p ~/.codeium/windsurf

  2. 添加您的配置：

    • 将上述配置复制到 ~/.codeium/windsurf/mcp_config.json
    • 替换 YOUR_TOKEN_HERE 使用您实际的GitHub个人访问令牌

  3. 拉取Docker镜像：

    docker pull ghcr.io/github/github-mcp-server

  4. 重启帆板：

    • 完全退出风帆冲浪（在Mac上按Cmd+Q）
    • 重新开放帆板运动

  5. 验证设置:

    • 在Windsurf中前往“管理MCP”
    • GitHub 服务器应该出现在列表中
    • 检查其连接是否无误

特点/特性

启用GitHub MCP服务器后，您可以：

  • 列表 & 搜索浏览仓库、问题、拉取请求、分支
  • 创建与更新创建问题、拉取请求、评论
  • 阅读内容查看文件内容、提交记录、差异（diffs）
  • 管理处理标签、里程碑、项目
  • 搜索跨仓库进行高级代码和问题搜索

故障排除

服务器未出现在管理MCP中

  • 验证配置文件是否存在且JSON格式有效
  • 检查 Docker 是否正在运行
  • 确保文件不是空的（0字节）
  • 更改后重启风帆冲浪游戏

“GITHUB_PERSONAL_ACCESS_TOKEN 未设置”错误

  • 确保令牌格式正确： -e GITHUB_PERSONAL_ACCESS_TOKEN=your_token
  • 不要使用单独的 env 使用 Docker 的对象
  • 验证您的令牌是否有效且未过期

Docker 镜像拉取失败

  • 检查您的网络连接
  • 验证 Docker 是否有权限从 ghcr.io 拉取镜像
  • 尝试手动拉动： docker pull ghcr.io/github/github-mcp-server

安全注意事项

⚠️ 重要的安全实践：

  • 永远不要将你的实际GitHub令牌提交到版本控制系统中
  • 使用环境变量或安全密钥管理
  • 定期更换令牌
  • 为令牌授予最小必要权限
  • 一旦泄露，立即撤销令牌

额外资源

许可证

此配置仅按原样提供，供个人使用。

最后更新时间2025年10月1日

相关 MCP