git-mcp

用途

GitMCP 旨在解决 AI 编程工具在生成代码时常见的“代码幻觉”问题。它是一个免费、开源的远程 MCP（模型上下文协议）服务器，能将任意公开 GitHub 项目（包括仓库和 GitHub Pages 站点）转换为可被 AI 助手访问的文档中心，使 AI 能够获取最新的项目文档与源代码，即使该模型此前从未接触过该项目。

主要能力

• 获取任意 GitHub 项目的文档与代码：为 AI 助手提供项目的最新文档和代码示例。
• 智能搜索：内置智能搜索能力，可在文档和代码中精准查找所需信息，避免消耗过多 token。
• 减少幻觉：基于真实文档和代码生成回答，提高准确性和代码正确性。
• 嵌入式聊天：可直接在浏览器中与仓库文档进行对话，快速上手。
• 零配置、云端运行：无需下载、安装、注册，只需将 GitMCP URL 添加为 IDE 中的 MCP 服务器即可。
• 开放、免费、隐私保护：开源且完全免费使用，不收集个人信息、不存储查询，并支持自托管。

使用方式

第一步：选择服务器类型

• 针对特定 GitHub 仓库：gitmcp.io/{owner}/{repo}
• 针对 GitHub Pages 站点：{owner}.gitmcp.io/{repo}
• 通用动态端点（可访问任意仓库）：gitmcp.io/docs

将 {owner} 替换为 GitHub 用户名或组织名，{repo} 替换为仓库名。也可在落地页使用转换工具将 GitHub URL 转换为 MCP URL。

第二步：连接 AI 助手

以 Cursor 为例，在 ~/.cursor/mcp.json 中配置；Claude Desktop 则进入 Settings > Developer > Edit Config，使用如下配置：

{
  "mcpServers": {
    "gitmcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://gitmcp.io/{owner}/{repo}"]
    }
  }
}

其他工具（Windsurf、VSCode、Cline、Highlight AI、Augment Code、Msty Studio 等）也提供了对应的配置说明。

工作原理

1. 用户向 AI 助手提供 GitMCP URL；2. 用户提出文档或代码相关问题；3. AI 经用户批准后向 GitMCP 发送请求；4. GitMCP 执行请求并返回数据；5. AI 基于真实数据生成更准确的回答。

可用工具

• fetch_<repo-name>_documentation：获取仓库的主要文档（如 llms.txt）。
• search_<repo-name>_documentation：在文档中进行智能搜索。
• fetch_url_content：获取文档中引用的外部链接内容并转换为易读格式。
• search_<repo-name>_code：使用 GitHub 代码搜索在仓库中查找代码示例或实现细节。 使用动态端点（gitmcp.io/docs）时，工具名称为 fetch_generic_documentation、search_generic_code、search_generic_documentation，并需额外指定目标仓库。

适用场景

• 使用小众、新发布或快速变化的库时，获取最新 API 用法和可靠代码示例。
• 需要 AI 基于具体仓库文档回答问题时。
• 通过嵌入式聊天快速了解项目文档。

限制与说明

• GitMCP 仅访问已公开的内容，且仅在用户查询时访问，不会自动抓取仓库。
• 访问 GitHub Pages 站点前会检查 robots.txt 并遵循站点所有者指令。
• 不永久存储项目或内容数据。
• 目前文档优先级为：AI 优化版项目文档、README.md。
• 该项目按“原样”提供，不提供任何担保；与 GitHub 及所提及的 AI 工具无隶属关系。
• 采用 Apache License 2.0 许可。