Phialsbasement MCP Github Server Plus

🚀 GitHub MCP 服務器指南

本指南將為你詳細介紹 GitHub MCP 服務器的使用方法，涵蓋安裝、支持的命令、配置示例以及許可證等內容，幫助你高效使用該服務器。

🚀 快速開始

要使用 GitHub MCP 服務器，你需要先安裝 Docker 並啟動服務。以下是具體步驟：

下載鏡像

docker pull mcp/github

啟動服務

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

✨ 主要特性

支持命令

• 倉庫信息：獲取倉庫的提交、分支和標籤信息。
• 代碼搜索：支持語言過濾、路徑限制和文件擴展名篩選。
• 問題管理：搜索開放或關閉的問題，按標籤分類。
• 拉取請求：查看合併狀態和檢查結果。
• 評論與審查：獲取代碼評論和審查意見。

📦 安裝指南

安裝 Docker 並啟動服務

下載鏡像

docker pull mcp/github

啟動服務

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

💻 使用示例

基礎用法

搜索代碼

q: "import express" language:typescript path:src/

搜索問題

q: "memory leak" is:issue is:open label:bug

搜索用戶

q: "fullstack developer" location:London followers:>100

高級用法

支持的 Git 命令

獲取倉庫信息

git ls-remote https://github.com/username/repo.git

創建新分支

git branch new-feature -f origin/main:main

提交更改

git push https://x-access-token:<TOKEN>@github.com/username/repo.git main

支持的 GitHub API 命令

獲取用戶信息

GET /users/{username}

獲取倉庫信息

GET /repos/{owner}/{repo}

創建新分支

POST /repos/{owner}/{repo}/branches

支持的代碼搜索命令

按語言搜索

language:javascript

按倉庫路徑搜索

repo:owner/name

按文件路徑搜索

path:app/src

📚 詳細文檔

個人訪問令牌設置

創建 GitHub 個人訪問令牌：

• 登錄 GitHub 賬戶，進入“開發者設置” > “個人訪問令牌”。
• 生成新令牌，並授予“repo”範圍權限。

Docker 配置示例

{
  "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": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

鏡像構建

docker build -t mcp/github -f src/github/Dockerfile .

設置與配置

個人訪問令牌

創建並配置個人訪問令牌，確保具有適當的權限（如“repo”範圍）。

集成到 Claude Desktop

在 claude_desktop_config.json 中添加 GitHub MCP 服務器配置。

📄 許可證

本 MCP 服務器基於 MIT 許可證。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。更多細節請參閱項目存儲庫中的 LICENSE 文件。

建議貢獻者

歡迎 fork 倉庫並提交 Pull Request。如有任何問題，請在 Issues 中提出。