Home
Login

GitHub MCP Server 是一個模型上下文協定(MCP)伺服器,旨在與 GitHub API 無縫整合,為開發人員和工具提供高級自動化和互動功能。

MITGo 15.6kgithub Last Updated: 2025-06-13

📦 GitHub MCP Server 介紹

GitHub MCP Server 是 GitHub 發布的官方開源工具,基於 Model Context Protocol(MCP)。它作用於本地環境,透過 Docker 或可執行檔,向 LLM(大語言模型)提供訪問 GitHub API 的能力,支持豐富的自動化與交互功能


🚀 發行與背景

  • 發布日期:2025 年 4 月 4 日,公開預覽版發布
  • 優化目標:由 Anthropic 提供初始參考服務,GitHub 則用 Go 重寫了完整功能並增強工具描述、支持代碼掃描等功能

🛠️ 功能特色

  1. MCP 工具集:包括 reposissuespull_requestscode_security(代碼掃描)、notifications 等,多達 7 個默認模塊

⚙️ 安裝與使用方式

Docker 方式

  1. 拉取鏡像:ghcr.io/github/github-mcp-server
  2. 啟動示例(VS Code 為例):
{
  "command": "docker",
  "args": [
    "run", "-i", "--rm",
    "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
  }
}
  • 可透過 GITHUB_TOOLSETSGITHUB_DYNAMIC_TOOLSETSGITHUB_READ_ONLYGITHUB_HOST 環境變量定制功能集、動態加載、只讀模式及自定義主機(GHES)

命令方式

  1. 克隆源碼並執行:
cd cmd/github-mcp-server
go build -o github-mcp-server
export GITHUB_PERSONAL_ACCESS_TOKEN=<token>
./github-mcp-server stdio
  1. 可在 VS Code / Claude Desktop 等 client 中配置 stdio 通道使用此二進制

🧩 使用場景

  • 自動化流程:自動創建 issue、拉取請求、評論、合併、代碼掃描等;
  • AI 驅動開發:結合 Copilot Chat、Claude Desktop 等 AI 客戶端,讓模型根據 GitHub 上下文進行智能建議、代碼審查;
  • 數據採集與分析:構建機器人,從倉庫抓取數據進行統計與分析;
  • 企業雲服務集成:支持 GitHub Enterprise Server / Cloud,透過 GITHUB_HOST 環境變量配置私有實例

⚙️ 配置示例簡介

使用方式 配置方式 說明
Docker 環境變量或命令行參數 設置 token、工具集、讀寫權限、主機
二進制直接運行 CLI 或 env 同 Docker 類似,適合彩線集成在 CI/CD 流程
VS Code config .vscode/mcp.json 或用戶設置 可共享項目配置
i18n / Tool 描述定制 github-mcp-server-config.json 更換提示信息或多國語言

🔧 MCP 與安全

  • 支持 --read-only 模式鎖定為不可寫狀態。
  • MCP 本身也可能帶來安全風險,社區已有研究指出潛在攻擊方式,建議搭配安全審計工具使用(如 MCPSafetyScanner 等)

📝 總結

github-mcp-server 是由 GitHub 官方基於 Anthropic MCP 協議開發的工具,旨在將 GitHub API 功能標準化呈現給 AI 模型。它具有高度可配置性、安全模式,並已集成至主流 AI 客戶端(VS Code Copilot Chat、Claude Desktop 等),適用於「AI 驅動開發」與 CI/CD 自動化場景,同時仍需關注 MCP 本身的安全隱患並配合審計工具使用。