GitHub MCP服务器

一个为GitHub集成提供的全面模型上下文协议(MCP)服务器实现,提供强大的仓库管理、问题跟踪和代码分析工具。

  • by Singularityent
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Singularityent/mcp-custom-github-server

使用说明

自定义GitHub MCP服务器

GitHub集成的全面模型上下文协议(MCP)服务器实现,为存储库管理、问题跟踪和代码分析提供了强大的工具。

特性

  • 库管理:创建、分叉、搜索和管理存储库
  • 发行与公关运营:创建、更新和管理问题并拉取请求
  • 代码分析:搜索代码、获取文件内容和分析存储库
  • 安全工具:访问代码扫描、可靠性警报和安全建议
  • 工作流管理:查看和管理GitHub操作工作流
  • 通知:处理GitHub通知和订阅

安装

先决条件

  • Node.js 18+或Python 3.8+
  • 具有适当作用域的GitHub个人访问令牌

设置

  1. 克隆此存储库:
git clone https://github.com/Singularityent/mcp-custom-github-server.git
cd mcp-custom-github-server
  1. 安装依赖项:
npm install
# or
pip install -r requirements.txt
  1. 设置您的GitHub令牌:
export GITHUB_PERSONAL_ACCESS_TOKEN="your_token_here"
  1. 运行服务器:
npm start
# or
python server.py

配置

服务器可以通过环境变量进行配置:

  • GITHUB_PERSONAL_ACCESS_TOKEN:您的GitHub个人访问令牌
  • GITHUB_HOST:GitHub主机名(默认:api.GitHub.com)
  • LOG_LEVEL:日志记录级别(默认值:info)
  • PORT:服务器端口(默认值:3000)

用法

带光标

添加到您的 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "github-custom": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

使用克劳德桌面

添加到您的Claude Desktop配置中:

{
  "mcpServers": {
    "github-custom": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

可用工具

存储库工具

  • search_repositories:搜索存储库
  • get_repository:获取存储库详细信息
  • create_repository:创建新存储库
  • fork_repository:分叉现有存储库

问题和公关工具

  • list_issues:列出存储库问题
  • create_issue:创建新问题
  • update_issue:更新现有问题
  • list_pull_requests:列出拉取请求
  • create_pull_request:创建新的pull请求

代码工具

  • search_code:跨存储库搜索代码
  • get_file_contents:获取文件内容
  • list_branches:列出存储库分支
  • create_branch:创建新分支

安全工具

  • list_code_scanning_alerts:列出代码扫描警报
  • list_dependabot_alerts:列出Dependabot警报
  • list_secret_scanning_alerts:列出秘密扫描警报

贡献

  1. 复刻仓库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

支持

有关问题和疑问,请在GitHub上打开问题。