github/github-mcp-serverView GitHub Homepage for Latest Official Releases
GitHub MCP Server 是一個模型上下文協定(MCP)伺服器,旨在與 GitHub API 無縫整合,為開發人員和工具提供高級自動化和互動功能。
MITGogithub-mcp-servergithub 20.3k Last Updated: August 07, 2025
📦 GitHub MCP Server 介紹
GitHub MCP Server 是 GitHub 發布的官方開源工具,基於 Model Context Protocol(MCP)。它作用於本地環境,透過 Docker 或可執行檔,向 LLM(大語言模型)提供訪問 GitHub API 的能力,支持豐富的自動化與交互功能
🚀 發行與背景
- 發布日期:2025 年 4 月 4 日,公開預覽版發布
- 優化目標:由 Anthropic 提供初始參考服務,GitHub 則用 Go 重寫了完整功能並增強工具描述、支持代碼掃描等功能
🛠️ 功能特色
- MCP 工具集:包括
repos
、issues
、pull_requests
、code_security
(代碼掃描)、notifications
等,多達 7 個默認模塊
⚙️ 安裝與使用方式
Docker 方式
- 拉取鏡像:
ghcr.io/github/github-mcp-server
- 啟動示例(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_TOOLSETS
、GITHUB_DYNAMIC_TOOLSETS
、GITHUB_READ_ONLY
、GITHUB_HOST
環境變量定制功能集、動態加載、只讀模式及自定義主機(GHES)
命令方式
- 克隆源碼並執行:
cd cmd/github-mcp-server
go build -o github-mcp-server
export GITHUB_PERSONAL_ACCESS_TOKEN=<token>
./github-mcp-server stdio
- 可在 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 本身的安全隱患並配合審計工具使用。