MCP GitHub 仓库服务器

一个提供访问 GitHub 仓库内容的 MCP（模型上下文协议）服务器。该服务器允许 AI 助手浏览和读取指定 GitHub 仓库中的文件。

演示

特性

资源

• 通过 URI 访问 GitHub 仓库中的任何文件
• 列出仓库内容并导航目录
• 支持特定分支的文件访问
• 文件内容以纯文本形式提供

资源 URI

• 基础 URL 格式：https://api.github.com/repos/{owner}/{repo}/contents/{path}
• 同时支持文件和目录
• 文件以 text/plain MIME 类型提供
• 目录以 application/x-directory MIME 类型提供

配置

服务器需要以下环境变量：

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name
GITHUB_BRANCH=branch_name  # Optional

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

安装

要在 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"
    }
  }
}

API 实现

服务器实现了三个主要的 MCP 端点：

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

认证

服务器使用 GitHub 个人访问令牌进行认证。确保您的令牌具有适当的权限来访问仓库内容。

错误处理

服务器包括以下错误处理：

• 缺少环境变量
• GitHub API 错误
• 无效路径（例如，尝试将目录作为文件读取）
• 认证失败

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能具有挑战性。使用 MCP Inspector 进行调试：

npm run inspector

这将提供一个 URL 以便在浏览器中访问调试工具。

安全注意事项

• 保护好您的 GitHub 个人访问令牌
• 考虑使用权限最小化的令牌
• 在访问大型仓库时注意仓库大小限制

许可证

MIT