/ 目录 / 演练场 / 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——把 owner/repo 填入 gitmcp.io
步骤
  1. 添加指向该库的 GitMCP
    pydantic/pydantic-ai 的 GitMCP 服务器添加到我的配置,然后列出顶层文档文件。✓ 已复制
    → 工具返回 README.md 及 /docs 目录树,没有虚构路径
  2. 基于真实源码提问
    用 pydantic-ai 的 GitMCP,给我看 Agent 的实际构造函数签名——直接引用源码,不要自行总结。✓ 已复制
    → 精确签名,附带源文件和行号引用
  3. 运行验证
    只用你在仓库里看到的内容写一个最小可运行示例。如有缺失,直说——不要猜。✓ 已复制
    → 示例可以编译运行;Claude 明确指出任何缺失部分

结果: 基于库的真实 API 完成集成,而非一段听起来合理却是虚构的代码。

注意事项
  • 库位于 monorepo 的子目录中 — 先用 tree 工具找到正确的包根目录,再读取文件
搭配使用: context7 · github

fork 前快速审查一个陌生的开源仓库

👤 评估依赖选型的工程师 ⏱ ~10 min beginner

何时使用: 你准备引入一个库,想在不克隆的情况下先摸清楚它的底细。

步骤
  1. 概览
    owner/repo 使用 GitMCP。用 8 行文字总结 README 加顶层目录体现的架构。✓ 已复制
    → 有目录引用的具体摘要,不是营销话术
  2. 风险扫描
    拉取包清单,列出所有依赖项。标记任何看起来已停止维护或有已知 CVE 记录的项目。✓ 已复制
    → 附逐项评估的依赖表格
  3. 适配性检查
    有没有插件/扩展 API 可以用,还是必须 fork?引用代码说明。✓ 已复制
    → 有文件路径引用的代码级回答

结果: 用 5 分钟、基于真实仓库内容做出 fork/采用/放弃的决策。

注意事项
  • 私有仓库但没有 token — 使用自托管 Docker 镜像并设置 GITHUB_TOKEN
搭配使用: github

组合

与其他 MCP 搭配,撬动十倍杠杆

git-mcp-idosal + context7

叠加两层最新文档——Context7 提供官方 SDK 文档,GitMCP 提供仓库源码

对比 context7 对 Foo.bar() 的说明与 GitMCP 的实际源码,有没有出入?✓ 已复制
git-mcp-idosal + github

GitMCP 负责只读文档查阅,GitHub MCP 负责创建 PR/Issue

通过 GitMCP 阅读贡献指南,然后用 GitHub MCP 提一个格式规范的 PR。✓ 已复制

工具

此 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)
凭据存储: 自托管模式下 token 以环境变量形式存储
数据出站: gitmcp.io(托管模式)或你自己的实例
切勿授予: repo:write

故障排查

常见错误与修复

403 rate limit exceeded

用 PAT 自托管,或等待——未认证限额为每小时 60 次

验证: Check X-RateLimit-Remaining header
Repo not found

检查 owner/repo 拼写是否正确,并确认仓库为公开状态。私有仓库请使用自托管镜像。

Returns truncated content

GitHub API 对原始 blob 有 1MB 上限,大文件请改用 search_code。

替代方案

GitMCP 对比其他方案

替代方案何时用它替代权衡
Context7你想要一个经过筛选的库文档界面,而非原始仓库内容Context7 只索引部分内容;GitMCP 覆盖任意公开仓库
GitHub MCP (official)你还需要 PR/Issue/写入操作GitHub MCP 支持写入(需要更严格的权限管控);GitMCP 是只读的

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

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