Github MCP Server S7g

🚀 GitHub MCP 服務器

GitHub MCP（模型上下文協議）服務器可與 GitHub 平臺進行交互，提供代碼搜索、問題管理、用戶信息查詢以及工作流程操作等功能，助力開發者高效管理項目。

🚀 快速開始

若要使用 GitHub MCP 服務器，需先創建 GitHub 個人訪問令牌，再根據自身需求進行相應配置。

✨ 主要特性

API 方法

倉庫和 Pull Request 操作

• 創建/更新 Issue 或 Pull Request：可發佈或更新問題或拉取請求。
• 評論 Issue 或 Pull Request：能在指定的問題或拉取請求上發佈評論。
• 獲取 Issue 或 Pull Request 的詳細信息：可查看問題或拉取請求的完整信息，如標題、描述和狀態。
• 獲取 Issue 或 Pull Request 的歷史記錄：可查看問題或拉取請求的歷史修改記錄。

代碼搜索

• 搜索代碼片段：可根據語言、路徑和擴展名等條件在特定倉庫中搜索代碼片段。

工作流程操作

• 觸發工作流程運行：能觸發 GitHub Actions 工作流程的運行。
• 獲取工作流程運行狀態：可查看工作流程運行的狀態和結果。

用戶和組織信息查詢

• 獲取用戶或組織的信息：可獲取特定用戶的個人資料信息或組織的詳細信息。

搜索語法

代碼搜索

• 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 的搜索文檔。

📦 安裝指南

個人訪問令牌

創建一個 GitHub 個人訪問令牌，以獲取對倉庫的完整控制權限：

1. 訪問 Personal access tokens（在 GitHub 設置 > 開發者設置中）。
2. 選擇所需的倉庫訪問權限（公共、所有或指定）。
3. 創建一個具有 repo 權限的令牌（如果僅處理公開倉庫，則可以選擇 public_repo 權限）。
4. 複製生成的令牌。

使用說明

Docker 配置

在 ~/.cursor/mcp_config.json 或 ~/.windsurf/mcp_config.json 中添加以下配置：

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX 配置

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "-e",
        "const mcp = require('mcp'); mcp.start();"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

💻 使用示例

基礎用法

創建 Issue

{
  "標題": "新功能請求",
  "描述": "請實現新功能...",
  "狀態": "已打開"
}

觸發工作流程運行

{
  "倉庫所有者": "username",
  "倉庫名稱": "repo-name",
  "分支": "main",
  "commit_message": "觸發工作流程"
}

🔧 技術細節

建議的構建命令

docker build -t mcp/github .

環境變量配置

以下是運行 GitHub MCP 服務器所需的環境變量：

• GITHUB_PERSONAL_ACCESS_TOKEN：必須設置為您的 GitHub 個人訪問令牌。
• PORT (可選)：設置服務監聽的端口，默認為 3000。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參考 LICENSE 文件。