GitHub 仓库 MCP 服务器

此模型上下文协议 (MCP) 服务器允许 AI 模型访问 GitHub 仓库内容作为上下文。它提供了用于获取文件内容、仓库结构和整个仓库的工具，以便在 AI 交互中用作上下文。

功能

• 获取整个仓库内容作为上下文
• 从仓库获取特定文件内容
• 获取仓库结构（文件列表）
• 按扩展名过滤文件
• 排除特定路径
• 限制返回的文件数量

安装

# 克隆仓库
git clone https://github.com/shanksxz/github-mcp.git
cd github-mcp

# 安装依赖
npm install

# 构建项目
npm run build

使用

设置 GitHub 身份验证

虽然服务器可以在没有身份验证的情况下使用公共仓库，但 GitHub API 对未经身份验证的请求有严格的速率限制（60 个请求/小时）。 要将此限制提高到 5000 个请求/小时，请设置 GITHUB_TOKEN 环境变量：

# 创建一个名为 gh.sh 的文件并添加以下行：
export GITHUB_TOKEN=your_github_personal_access_token
# 使文件可执行
chmod +x gh.sh
# 运行文件
./gh.sh

您可以在 GitHub 开发者设置 中创建个人访问令牌。

与 Cursor 一起使用

要将此服务器与 Cursor 一起使用，请按照以下步骤操作：

1. 打开 Cursor 设置
2. 搜索 "MCP"
3. 点击 "添加新的 MCP 服务器"
4. 输入以下信息：
   • 名称：github-repo-context（或您想要的任何名称）
   • 类型：命令
   • 命令：/path/to/your-local-repo-setup/gh.sh
5. 点击 "保存"
6. 通过点击服务器名称旁边的切换按钮启用服务器
7. 现在您应该能够在您的项目中使用该服务器了

服务器通过 stdin/stdout 按照 MCP 协议进行通信。

可用工具

服务器提供以下工具：

1. get-repo-context: 获取 GitHub 仓库中的所有文件以用作上下文

   • 参数：
     • owner: GitHub 仓库所有者/组织名称
     • repo: GitHub 仓库名称
     • maxFiles (可选): 要包含的最大文件数（默认值：50）
     • fileExtensions (可选): 要包含的文件扩展名（例如，['js', 'ts', 'md']）
     • excludePaths (可选): 要排除的路径（默认值：['node_modules', 'dist', 'build']）

2. get-file-content: 获取 GitHub 仓库中特定文件的内容

   • 参数：
     • owner: GitHub 仓库所有者/组织名称
     • repo: GitHub 仓库名称
     • path: 仓库中文件的路径

3. get-repo-structure: 获取 GitHub 仓库的结构

   • 参数：
     • owner: GitHub 仓库所有者/组织名称
     • repo: GitHub 仓库名称

示例

当与支持 MCP 的 AI 模型集成时，您可以使用如下命令：

获取仓库 tensorflow/tensorflow 的结构

然后，AI 将使用 get-repo-structure 工具来获取并显示仓库结构。