/ 目錄 / 演練場 / GitMCP
● 社群 idosal ⚡ 即開即用

GitMCP

作者 idosal · idosal/git-mcp

將任何公開的GitHub儲存庫轉換為即時MCP端點:將其README、程式碼和文件拉入Claude ,而無需複製或產生幻覺的API。

GitMCP在gitmcp.io/ {owner}/{repo}託管遠端MCP伺服器。Claude獲得工具來擷取文件、搜尋回收庫、列出檔案和讀取特定路徑—始終針對當前主分支。移除使用陌生程式庫時的「Claude組成了不存在的函式」錯誤類別。

為什麼要用

核心特性

即時演示

實際使用效果

git-mcp-idosal.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "git-mcp-idosal",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "git-mcp-idosal": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://gitmcp.io/{owner}/{repo}"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add git-mcp-idosal -- npx -y mcp-remote https://gitmcp.io/{owner}/{repo}

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: GitMCP

如何阻止Claude對其半知半解的圖書館產生幻覺API

👤 使用較新程式庫(截止後)或利基SDK的開發人員 ⏱ ~15 min beginner

何時使用: 您正在整合圖書館, Claude不斷發明不存在的方法名稱。

前置條件
  • 瞭解圖書館的GitHub路徑 — 例如`pydantic/pydantic-ai' —將所有者/儲存庫貼到gitmcp.io中
步驟
  1. 添加指向庫的GitMCP
    將'pydantic/pydantic-ai`的GitMCP伺服器添加到我的配置中,然後列出頂級文檔文件。✓ 已複製
    → 工具傳回README.md plus/docs樹狀結構—沒有製造的路徑
  2. 詢問真實來源
    將GitMCP用於pydantic-ai ,向我展示「客服人員」的實際建構子簽名—從來源引用,不要總結。✓ 已複製
    → 具有源文件+行參考的確切簽名
  3. 執行驗證
    僅使用您在儲存庫中看到的內容撰寫最小可執行範例。如果遺漏了什麼,請說出來,不要猜測。✓ 已複製
    → 範例編譯; Claude標記任何遺漏的部分

結果: 與圖書館的實際API相匹配的工作整合,而不是一個聽起來合理的虛構。

注意事項
  • 庫位於monorepo子目錄中 — 請先使用「樹狀圖」工具尋找正確的套件根目錄,然後再閱讀
搭配使用: context7 · github

在分叉前快速審核不熟悉的開放原始碼儲存庫

👤 工程師評估相依性 ⏱ ~10 min beginner

何時使用: 你即將採用一個圖書館,並想知道你在沒有克隆的情況下進入了什麼。

步驟
  1. 概述
    將GitMCP用於owner/repo。以8行總結README +頂級目錄的架構。✓ 已複製
    → 具體目錄錨定摘要,而非行銷鬆弛
  2. 風險掃描
    提取套件資訊清單並列出每個相依性。標記任何看似被遺棄或已知CVE歷史記錄的內容。✓ 已複製
    → 包含每個項目評估的依存項表
  3. 貼合度檢查
    是否有我可以使用的插件/擴展API ,或者我是否需要分叉?引用代碼。✓ 已複製
    → 具有檔案路徑的代碼錨定答案

結果: 由實際回購內容支持的5分鐘分叉/採用/跳過決定。

注意事項
  • 不含令牌的私有回購 — 使用自託管的Docker映像並設定GITHUB_TOKEN
搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

git-mcp-idosal + context7

堆疊兩層最新文檔—官方SDK文檔的Context7 ,庫源的GitMCP

通過GitMCP將context7對Foo.bar ()的說法與實際來源進行比較。有偏差嗎?✓ 已複製
git-mcp-idosal + github

將GitMCP用於唯讀文件,將GitHub MCP用於PR/議題建立

透過GitMCP閱讀貢獻指南,然後透過GitHub MCP開啟格式良好的公關。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
fetch_documentation owner, repo 探索陌生倉庫時的第一通電話 1 GitHub API call
search_documentation owner, repo, query: str 查找提及特定概念的文件部分 1 API call
fetch_url_content url: str 按RAW URL提取特定文件 free
search_code owner, repo, query: str 尋找符號的定義或使用位置 1 API call

成本與限制

運行它的成本

API 配額
GitHub未驗證:每個IP 60個請求/小時。已驗證: 5000次/小時。
每次呼叫 Token 數
500–5000 (視檔案而定)
費用
免費(託管)
提示
使用search_*工具,而不是傾印整個檔案

安全

權限、密鑰、影響範圍

最小權限: public_repo (for private access)
憑證儲存: 在自託管模式下,令牌爲env var
資料出站: gitmcp.io (託管)或您自己的實例
切勿授予: repo:write

故障排查

常見錯誤與修復

超出403速率限制

透過PAT或WAIT自助出租—未經授權的限制為每小時60次

驗證: Check X-RateLimit-Remaining header
無結果

請檢查owner/repo拼寫是否公開。如為私密,請使用自我託管圖片。

返回截斷的內容

GitHub API的原始Blob上限爲1MB。對於大型檔案,請使用SEARCH_CODE。

替代方案

GitMCP 對比其他方案

替代方案何時用它替代權衡
Context7您想要精心策劃的圖書館文件表面,而不是原始儲存庫Context7僅索引子集; GitMCP涵蓋任何公共回購
GitHub MCP (official)您也需要PR/發行/寫入操作GitHub MCP可寫入(更多功能可鎖定) ; GitMCP為唯讀

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills