MCP GitHub Repository Server

MCP GitHub Repository Server

与GitHub仓库交互的MCP Server。

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

安装与配置

1. 设置环境变量

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name
GITHUB_BRANCH=branch_name  # 可选

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": "/path/to/mcp-server-github-repo/build/index.js"
    }
  }
}

使用方式

通过资源 URI 访问 GitHub 仓库内容:

  • 基础格式: https://api.github.com/repos/{owner}/{repo}/contents/{path}
  • 支持文件和目录浏览
  • 文件以纯文本形式提供

开发与调试

开发模式(自动重建):

npm run watch

调试:

npm run inspector

安全提示

  • 保护您的 GitHub 访问令牌
  • 使用最小权限令牌
  • 留意大型仓库的访问限制

许可证

MIT