MCP GitHub Repository Server

概述

MCP GitHub 仓库服务器允许 AI 助手浏览和读取指定 GitHub 仓库中的文件内容。

主要功能

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

安装步骤

1. 配置环境变量

GITHUB_PERSONAL_ACCESS_TOKEN=你的github令牌
GITHUB_OWNER=仓库所有者
GITHUB_REPO=仓库名称
GITHUB_BRANCH=分支名称  # 可选

2. 构建服务器

npm install
npm run build

3. 配置 Claude Desktop

配置文件位置:

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

添加以下配置:

{
  "mcpServers": {
    "mcp-server-github-repo": {
      "command": "/到/mcp-server-github-repo/build/index.js的路径"
    }
  }
}

使用方法

服务器实现了两个主要端点:

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

调试

使用 MCP 检查器进行调试:

npm run inspector

开发模式

npm run watch  # 自动重建

安全注意事项

• 使用最小必要权限的访问令牌
• 注意大型仓库的大小限制

许可证

MIT