MCP GitHub 仓库服务器

一个 MCP (模型上下文协议) 服务器，提供对 GitHub 仓库内容的访问。该服务器允许 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  # 可选

开发

安装依赖项：

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 Personal Access Token 进行身份验证。 确保您的令牌具有访问仓库内容的适当权限。

错误处理

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

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

调试

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

npm run inspector

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

安全注意事项

• 确保您的 GitHub Personal Access Token 安全
• 考虑使用具有最小所需权限的令牌
• 注意访问大型仓库时的仓库大小限制

许可证

MIT