GitHub Repository MCP Server

此模型上下文协议（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. 您现在应该能够在项目中使用该服务器

服务器通过遵循MCP协议的stdin/stdout进行通信。

可用工具

服务器提供以下工具：

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工具来获取并显示仓库结构。