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上打开问题。