git-mcp

让 AI 直接读你 GitHub 代码，告别瞎编乱造

GitMCP 是一个免费开源的远程 MCP（模型上下文协议）服务器，专为 GitHub 项目设计，旨在解决 AI 编程助手因缺乏最新代码上下文而产生的“代码幻觉”问题。它允许任何 AI 助手（如 Claude、Cursor 等）通过标准 MCP 协议远程访问任意 GitHub 仓库的完整代码结构、文件内容、提交历史、分支信息等，从而让 AI 在回答或生成代码时基于真实仓库数据，而非训练时的旧知识。核心能力包括：自动索引仓库、提供语义化代码搜索、支持按文件路径或符号名检索、暴露仓库元数据、以及通过远程端点无缝集成到现有 AI 工具中。项目采用 TypeScript 编写，部署简单，支持自托管，适合个人开发者、团队以及企业级应用，能显著提升 AI 辅助开发的准确性和可靠性。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 8414

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队idosal

所属国家

官网地址https://gitmcp.io

GitHubhttps://github.com/idosal/git-mcp

定价模式free

价格说明完全免费开源，可自行部署，无付费版本

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agentic-ai,agents,ai,claude,copilot,cursor,git,llm,mcp

GitHub 星标★ 8414

30天Star增速

HF 下载量

上线时间2025-03-29 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 4 步

环境要求

已安装 Git（用于克隆仓库）
已安装 Node.js 运行环境
已安装 pnpm 包管理器（README 使用 pnpm install/pnpm dev）
可访问 GitHub 与 gitmcp.io 的网络

安装与启动步骤

1克隆项目仓库

把 GitMCP 源码克隆到本地并进入项目目录，目录名默认为 git-mcp。
```
git clone https://github.com/idosal/git-mcp.git
cd git-mcp
```
2安装项目依赖

在项目根目录安装 TypeScript 项目依赖，README 指定使用 pnpm。
```
pnpm install
```
3本地启动开发服务

以开发模式运行服务，README 给出 npm run dev 或 pnpm dev 两种写法。
```
npm run dev
```
4在 AI 工具中接入

把远程 MCP 端点填入 Cursor、Claude 等支持 MCP 的客户端，owner/repo 换成目标仓库。

关键配置

配置项	必填	说明	示例
`MCP 服务地址（特定仓库）`	是	指向某一个 GitHub 仓库，AI 只访问该项目，更安全	`https://gitmcp.io/idosal/git-mcp`
`MCP 服务地址（子域名形式）`	否	同一仓库的另一种写法，owner 作为子域名前缀	`https://idosal.gitmcp.io/git-mcp`

如何确认成功

本地运行时终端无报错并输出监听地址；配置端点后打开 https://gitmcp.io/idosal/git-mcp 能正常返回该仓库的文档与代码信息。

常见问题

Q：必须把项目部署到本地才能用吗？

A：不需要。GitMCP 是免费的远程 MCP 服务器，直接把 gitmcp.io/{owner}/{repo} 这样的端点填进 AI 工具即可使用，本地安装只用于二次开发。

Q：为什么要用「特定仓库」这种端点？

A：按 README 说明，指定 owner/repo 能让 AI 助手始终锁定目标项目，避免访问无关仓库，从而提高安全性和结果相关性。

Q：支持哪些 AI 工具？

A：README 明确提到 Cursor、Claude 等支持 MCP 协议的 AI 工具，以及 GitHub 仓库和 GitHub Pages 项目。

Q：本地开发应该用 npm 还是 pnpm？

A：README 在安装依赖处写的是 pnpm install，启动处同时给出 npm run dev 和 pnpm dev，建议保持与安装一致使用 pnpm。

注意事项

示例中的 owner/repo 需替换成你实际要接入的仓库，如 idosal/git-mcp。
README 未给出本地服务的端口号、密钥等配置，具体以启动后的终端输出为准。
仅依据 README 节选整理，更多客户端配置细节请查阅项目官网 gitmcp.io 与仓库 README。

核心亮点

直接连接 GitHub 仓库，AI 基于实时代码回答，减少幻觉
支持远程 MCP 协议，可无缝接入 Claude、Cursor 等主流 AI 工具
自动索引仓库结构，提供语义搜索，快速定位代码片段

不足之处

依赖 GitHub API，大仓库索引可能较慢或受速率限制
文档/社区待观察

适用场景

AI 编程助手需要理解特定仓库代码时
团队协作中让 AI 基于最新代码库提供建议
代码审查或重构时快速获取上下文

替代项目

GitHub Copilot、Sourcegraph、Continue

项目介绍

git-mcp 是智能体领域的开源项目，由 idosal 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（8,414）位列前 6%，在智能体分类的 2,520 个项目里位列前 6%。

近 41 天，它的 GitHub 星标从 8,325 增加到 8,414，净增 89。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。完全免费开源，可自行部署，无付费版本。

它主要面向的使用场景是：AI编程助手需要理解特定仓库代码时。同类可对比的替代方案包括 GitHub Copilot、Sourcegraph、Continue。

上一篇：mcp-agent

下一篇：osaurus