Zerops MCP

🚀 GitHub MCP 服務器

GitHub MCP（Model Context Protocol）服務器提供了與 GitHub 平臺交互的功能，支持代碼搜索、問題跟蹤、倉庫管理等操作，能應用於開發輔助、項目管理等多種場景，有效提升開發和協作效率。

🚀 快速開始

安裝依賴

運行以下命令安裝必要的依賴：

npm install @github/mcp-server --save

初始化服務器

創建並運行以下配置文件 mcp-config.json：

{
  "servers": {
    "github": {
      "url": "https://api.github.com",
      "token": "your-personal-access-token"
    }
  }
}

✨ 主要特性

概念

GitHub MCP 服務器提供了與 GitHub 平臺交互的功能，支持以下操作：

• 代碼搜索：通過語言、路徑、文件擴展名等條件搜索代碼
• 問題跟蹤：查看和管理問題（Issues）和拉取請求（Pull Requests）
• 倉庫管理：創建、刪除和管理倉庫
• 團隊協作：與團隊成員協作，管理團隊和權限
• 活動監控：監控倉庫的提交歷史和活動記錄

使用場景

• 開發輔助：快速查找代碼片段或功能實現
• 項目管理：跟蹤問題和拉取請求的狀態
• 自動化工作流：集成到 CI/CD 工作流中進行自動測試和部署
• 團隊協作：在團隊內部高效地管理和分配任務

📦 安裝指南

個人訪問令牌

創建 GitHub 個人訪問令牌：

• 登錄 GitHub 賬戶設置
• 選擇需要權限的倉庫（公共、全部或指定）
• 創建具有 repo 權限的令牌（推薦使用 public_repo 權限處理公開倉庫）

集成到 Claude Desktop

將以下配置添加到 claude_desktop_config.json：

Docker 方式：

{
  "mcpServers": {
    "github": {
      "type": "docker",
      "containerName": "github-mcp-server",
      "imageName": "ghcr.io/your-org/github-mcp:latest"
    }
  }
}

直接配置方式：

{
  "mcpServers": {
    "github": {
      "type": "direct",
      "endpoint": "http://localhost:3000",
      "token": "your-personal-access-token"
    }
  }
}

💻 使用示例

命令行工具

安裝工具

使用 npm 包管理器安裝：

npm install -g @github/mcp-cli

基礎用法

以下是一些常見操作的使用示例：

1. 登錄 GitHub 賬戶：

mcp login --token your-personal-access-token

2. 搜索代碼片段：

mcp search "node.js" --language=typescript

3. 創建新倉庫：

mcp create-repo my-new-repo

搜索語法使用示例

代碼搜索

通過以下語法可以實現精確的代碼搜索：

• language:javascript：按編程語言篩選
• repo:owner/name：指定倉庫範圍
• path:app/src：按文件路徑篩選
• extension:js：按文件擴展名篩選
• 示例：q: "import express" language:typescript path:src/

問題搜索

通過以下語法可以實現問題和拉取請求的搜索：

• is:issue 或 is:pr：按類型篩選
• is:open 或 is:closed：按狀態篩選
• label:bug：按標籤篩選
• author:username：按作者篩選
• 示例：q: "memory leak" is:issue is:open label:bug

用戶搜索

通過以下語法可以實現用戶或組織的搜索：

• type:user 或 type:org：按賬戶類型篩選
• followers:>1000：按關注者數量篩選
• location:London：按地理位置篩選
• 示例：q: "fullstack developer" location:London followers:>100

詳細搜索語法

請參考GitHub 官方文檔。

📚 詳細文檔

常見問題

1. 如何獲取個人訪問令牌？

• 登錄 GitHub 賬戶，進入 賬戶設置
• 點擊 "Generate new token" 按鈕
• 配置權限後生成令牌

2. 如何解決認證問題？

• 確保令牌具有正確的權限（至少需要 repo 權限）
• 檢查令牌是否已過期或被 revoke

開發指南

擴展功能

• 自定義命令：開發新的 CLI 命令擴展功能
• 插件系統：創建可插拔的組件擴展服務器功能
• 鉤子機制：實現預處理和後處理邏輯

貢獻代碼

1. Fork 項目倉庫
2. 創建功能分支
3. 提交代碼併發起 Pull Request

📄 許可證

本項目遵循 MIT 協議，具體內容如下：

MIT License
Copyright (c) [年份] [作者姓名]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

貢獻者

• [你的名字] - 初始開發
• [其他貢獻者姓名] - 功能擴展

通過以上指南，您可以輕鬆地將 GitHub MCP 服務器集成到您的開發流程中，並提升團隊協作效率。