github

GitHub MCP 服务

用于 GitHub 操作的模型上下文协议（MCP）服务。此服务可让 AI 助手通过标准化接口与 GitHub 仓库交互。

功能

• 🔍 列出和查看拉取请求 - 浏览 PR，并使用筛选选项
• 📋 列出和查看议题 - 查看议题及其标签、受理人和评论
• 📊 仓库信息 - 获取仓库统计数据和元数据
• 🔎 代码搜索 - 搜索 GitHub 仓库中的代码

安装

npm install -g @bountyclaw/mcp-github-server

配置

将 GitHub 令牌设为环境变量：

export GITHUB_TOKEN=your_github_token_here

也可以在以编程方式创建客户端时传入令牌。

在 Claude Code 中使用

将以下内容添加到 Claude Code MCP 设置中：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@bountyclaw/mcp-github-server"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

可用工具

1. github_pr_list

列出仓库的拉取请求。

输入：

• owner（字符串，必填）：仓库所有者
• repo（字符串，必填）：仓库名称
• state（枚举，可选）：按状态筛选（open、closed、all）
• head（字符串，可选）：按头部分支筛选
• base（字符串，可选）：按基准分支筛选
• sort（枚举，可选）：排序字段
• direction（枚举，可选）：排序方向
• per_page（数字，可选）：每页结果数（最多 100）
• page（数字，可选）：页码

2. github_pr_view

查看特定拉取请求的详细信息。

输入：

• owner（字符串，必填）：仓库所有者
• repo（字符串，必填）：仓库名称
• pull_number（数字，必填）：PR 编号
• include_diff（布尔值，可选）：包含差异内容

3. github_issue_list

列出仓库的议题。

输入：

• owner（字符串，必填）：仓库所有者
• repo（字符串，必填）：仓库名称
• state（枚举，可选）：按状态筛选
• labels（字符串，可选）：以逗号分隔的标签名称
• assignee（字符串，可选）：按受理人筛选
• creator（字符串，可选）：按创建者筛选
• sort（枚举，可选）：排序字段
• direction（枚举，可选）：排序方向
• per_page（数字，可选）：每页结果数
• page（数字，可选）：页码

4. github_issue_view

查看特定议题的详细信息。

输入：

• owner（字符串，必填）：仓库所有者
• repo（字符串，必填）：仓库名称
• issue_number（数字，必填）：议题编号
• include_comments（布尔值，可选）：包含评论

5. github_repo_info

获取仓库信息和统计数据。

输入：

• owner（字符串，必填）：仓库所有者
• repo（字符串，必填）：仓库名称

6. github_search_code

搜索 GitHub 中的代码。

输入：

• query（字符串，必填）：搜索查询（GitHub 代码搜索语法）
• sort（枚举，可选）：排序字段（indexed、best-match）
• order（枚举，可选）：排序顺序
• per_page（数字，可选）：每页结果数
• page（数字，可选）：页码

查询示例

"List open PRs in facebook/react"
"Show me issue #123 in microsoft/vscode"
"Get info about the kubernetes/kubernetes repo"
"Search for 'useEffect' in TypeScript files"

开发

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Format
npm run format

测试

项目包含全面的单元测试，覆盖率超过 90%：

• GitHub API 客户端测试
• 全部 6 个工具的处理程序测试
• 错误处理测试
• 输入验证测试

npm test

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

贡献

欢迎贡献！欢迎提交拉取请求。

---

由 BountyClaw 倾力打造 🦞