MCP GitHub Repository Server

基本能力

产品定位

MCP GitHub Repository Server 是一个专门为 AI 助手设计的 GitHub 仓库内容访问服务，旨在提供便捷的代码和文件浏览功能。

核心功能

1. 资源访问
2. 通过 URI 访问 GitHub 仓库中的任何文件
3. 列出仓库内容并导航目录
4. 支持特定分支的文件访问

5. 文件内容以纯文本形式提供

6. 资源 URI

7. 基础 URL 格式：https://api.github.com/repos/{owner}/{repo}/contents/{path}
8. 支持文件和目录
9. 文件以 text/plain MIME 类型提供

10. 目录以 application/x-directory MIME 类型提供

11. API 实现

12. ListResources - 列出仓库中的文件和目录
13. ReadResource - 检索特定文件的内容

适用场景

1. AI 助手需要访问和浏览 GitHub 仓库内容
2. 开发者需要快速查看或分析 GitHub 仓库中的代码
3. 需要自动化处理 GitHub 仓库内容的场景

工具列表

1. MCP Inspector
2. 用于调试 MCP 服务器
3. 提供浏览器访问的调试工具

常见问题解答

1. 认证问题

2. 确保 GitHub 个人访问令牌具有访问仓库内容的适当权限

3. 错误处理

4. 服务器包含对缺失环境变量、GitHub API 错误、无效路径和认证失败的处理

5. 安全注意事项

6. 保持 GitHub 个人访问令牌的安全
7. 考虑使用具有最小必需权限的令牌
8. 注意访问大型仓库时的仓库大小限制

使用教程

使用依赖

1. 安装 Node.js 环境
2. 获取 GitHub 个人访问令牌

安装教程

1. 克隆仓库
2. 安装依赖

npm install

1. 构建服务器

npm run build

1. 开发模式（自动重建）

npm run watch

1. 配置 Claude Desktop

在配置文件中添加服务器配置：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-github-repo": {
      "command": "/path/to/mcp-server-github-repo/build/index.js"
    }
  }
}

调试方式

使用 MCP Inspector 进行调试：

npm run inspector

这将提供一个 URL，用于在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。