/ 目录 / 演练场 / 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

如何阻止克劳德对它一无所知的图书馆的幻觉API

👤 使用较新库(截止后)或利基SDK的开发人员 ⏱ ~15 min beginner

何时使用: 您正在整合一个库, Claude不断发明不存在的方法名称。

前置条件
  • 了解库的GitHub路径 — 例如`pydantic/pydantic-ai' —将所有者/存储库粘贴到gitmcp.io中
步骤
  1. 添加指向库的GitMCP
    将'pydantic/pydantic-ai`的GitMCP服务器添加到我的配置中,然后列出顶级文档文件。✓ 已复制
    → 工具返回README.md plus/docs树—没有制造的路径
  2. 询问真实来源
    使用pydantic-ai的GitMCP ,向我展示“Agent”的实际构造函数签名—从源引用,不要总结。✓ 已复制
    → 带有源文件+行引用的确切签名
  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 按原始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

故障排查

常见错误与修复

超出了速率限制。

通过PAT或WAIT自助出租—未授权限制为60个请求/小时

验证: Check X-RateLimit-Remaining header
未找到

检查所有者/存储库的拼写是否公开。对于隐私,请使用自托管图片。

返回截断的内容

GitHub API将原始blob限制为1MB。对于大文件,请使用SEARCH_CODE。

替代方案

GitMCP 对比其他方案

替代方案何时用它替代权衡
Context7您想要一个精心策划的库文档表面,而不是原始存储库Context7仅索引子集; GitMCP涵盖任何公共存储库
GitHub MCP (official)您还需要PR/问题/写入操作GitHub MCP具有写入功能(更多功能可锁定) ; GitMCP为只读

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills