Превращает любой GitHub-репозиторий в MCP-сервер документации — AI-агент может читать README, wiki и код проекта без клонирования. Remote-first.
Remote SSE-сервер, локальная установка не нужна.
Замените {owner}/{repo} на нужный репозиторий GitHub.
# Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"gitmcp": {
"command": "npx",
"args": ["mcp-remote", "https://gitmcp.io/{owner}/{repo}"]
}
}
}
# Claude Code (CLI):
claude mcp add gitmcp -- npx mcp-remote https://gitmcp.io/microsoft/vscode
# OpenCode — ~/.config/opencode/opencode.json:
{
"mcp": {
"gitmcp": {
"type": "local",
"command": ["npx", "mcp-remote", "https://gitmcp.io/{owner}/{repo}"]
}
}
}
Что такое GitMCP • Возможности • Быстрое начало • Как это работает • Значок • Примеры • Часто задаваемые вопросы • Конфиденциальность • Участие в разработке • Лицензия
Хватит галлюцинировать, начните кодить!
GitMCP — это бесплатный, open-source удаленный сервер Model Context Protocol (MCP), который превращает любой проект на GitHub (репозитории или GitHub Pages) в центр документации. Он позволяет инструментам ИИ, таким как Cursor, получить доступ к актуальной документации и коду, даже если языковая модель никогда их не видела, тем самым бесшовно устраняя галлюцинации в коде.
GitMCP поддерживает два варианта -
gitmcp.io/{owner}/{repo} или {owner}.gitmcp.io/{repo}): Используйте их, когда вы в основном работаете с определенным набором библиотек. Это гарантирует, что ваш ИИ-помощник всегда обращается к правильному проекту, повышая безопасность и релевантность, предотвращая доступ к нежелательным репозиториям.gitmcp.io/docs): Используйте его для максимальной гибкости, когда вам нужно часто переключаться между разными репозиториями. ИИ-помощник будет запрашивать у вас (или решать на основе контекста), какой репозиторий использовать для каждого запроса. Имейте в виду, что это зависит от правильного определения целевого репозитория каждый раз.С GitMCP:
Например, этот сравнительный показывает результат для одного и того же промпта в Cursor при создании сцены three.js -
https://github.com/user-attachments/assets/fbf1b4a7-f9f0-4c0e-831c-4d64faae2c45
Использовать GitMCP легко! Просто выполните следующие шаги:
Выберите один из следующих форматов URL в зависимости от того, к чему вы хотите подключиться:
gitmcp.io/{owner}/{repo}{owner}.gitmcp.io/{repo}gitmcp.io/docsЗамените {owner} на имя пользователя или организации GitHub, а {repo} — на название репозитория.
Для вашего удобства вы также можете использовать инструмент конвертации на главной странице для форматирования URL GitHub в MCP URL!
Выберите вашего ИИ-помощника из приведенных ниже вариантов и следуйте инструкциям по настройке:
Обновите конфигурационный файл Cursor по адресу ~/.cursor/mcp.json:
json
{
"mcpServers": {
"gitmcp": {
"url": "https://gitmcp.io/{owner}/{repo}"
}
}
}
json
{
"mcpServers": {
"gitmcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}Обновите конфигурационный файл Windsurf по адресу ~/.codeium/windsurf/mcp_config.json:
json
{
"mcpServers": {
"gitmcp": {
"serverUrl": "https://gitmcp.io/{owner}/{repo}"
}
}
}
Обновите конфигурационный файл VSCode по адресу .vscode/mcp.json:
json
{
"servers": {
"gitmcp": {
"type": "sse",
"url": "https://gitmcp.io/{owner}/{repo}"
}
}
}
Обновите конфигурационный файл Cline по адресу ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
json
{
"mcpServers": {
"gitmcp": {
"url": "https://gitmcp.io/{owner}/{repo}",
"disabled": false,
"autoApprove": []
}
}
}
Имя плагина: gitmcp
SSE URL: https://gitmcp.io/{owner}/{repo}
Для получения дополнительной информации о добавлении пользовательских MCP-серверов в HighlightAI обратитесь к документации.
Назовите MCP-сервер: git-mcp Docs
Используйте эту команду:
npx mcp-remote https://gitmcp.io/{owner}/{repo}
Или используйте следующую конфигурацию:
{
"mcpServers": {
"git-mcp Docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}
{
"mcpServers": {
"git-mcp Docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}
Для получения дополнительной информации о настройке MCP-серверов в Augment Code посетите документацию Augment Code.
Примечание: Помните, что нужно заменить
{owner}и{repo}на фактическое имя пользователя/организации GitHub и название репозитория. Вы также можете использовать динамический эндпоинтhttps://gitmcp.io/docs, чтобы разрешить вашему ИИ получить доступ к любому репозиторию по запросу.
GitMCP подключает вашего ИИ-помощника к репозиториям GitHub, используя Model Context Protocol (MCP) — стандарт, который позволяет инструментам ИИ запрашивать дополнительную информацию из внешних источников.
Что происходит при использовании GitMCP:
gitmcp.io/microsoft/typescript). GitMCP предоставляет такие инструменты, как получение документации, умный поиск, поиск кода и т.д.GitMCP в настоящее время поддерживает следующие документы (в порядке приоритета):
1. llms.txt
2. Оптимизированная для ИИ версия документации проекта
3. README.md/корень
Вот несколько примеров того, как использовать GitMCP с различными ИИ-помощниками и репозиториями:
Для GitHub-репозитория https://github.com/microsoft/playwright-mcp добавьте https://gitmcp.io/microsoft/playwright-mcp как MCP-сервер в Windsurf.
Запрос к Claude:
"Как мне использовать Playwright MCP"
Windsurf получит соответствующую документацию из GitMCP для корректной реализации функции памяти.
Для сайта GitHub Pages langchain-ai.github.io/langgraph добавьте https://langchain-ai.gitmcp.io/langgraph как MCP-сервер в Cursor.
Запрос к Cursor:
"Добавь память моему агенту LangGraph"
Cursor получит соответствующую документацию и код из GitMCP для корректной реализации функции памяти.
Вам не нужно выбирать конкретные репозитории. Универсальная конечная точка gitmcp.io/docs позволяет ИИ выбирать проект GitHub на лету!
Запрос к любому ИИ-ассистенту:
"Я хочу узнать о модели распознавания речи OpenAI Whisper. Объясни, как она работает."
Claude получит данные из GitMCP и ответит на вопрос.
GitMCP предоставляет ИИ-ассистентам несколько ценных инструментов, которые помогают им получать доступ к репозиториям GitHub, понимать их и выполнять запросы.
fetch_<repo-name>_documentationЭтот инструмент получает основную документацию из репозитория GitHub. Он работает, извлекая соответствующую документацию (например, 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) и требуют дополнительной информации о том, к какому репозиторию обращаться.
GitMCP предоставляет значок для README вашего репозитория. Он позволяет пользователям быстро получить доступ к вашей документации через их IDE или браузер (с использованием встроенного чата). Он также отображает количество раз, когда ваша документация была просмотрена через GitMCP.
Добавьте следующее в ваш README.md:
<a href="https://gitmcp.io/OWNER/REPO"><img src="https://img.shields.io/endpoint?url=https://gitmcp.io/badge/OWNER/REPO" alt="GitMCP"></a>
Замените OWNER на ваше имя пользователя GitHub или организацию, а REPO — на имя вашего репозитория.
Значение увеличивается при каждом вызове инструмента для конкретного репозитория.
Вы можете настроить внешний вид значка с помощью параметров:
| Параметр | Описание | По умолчанию | Пример |
|---|---|---|---|
color |
Цвет для значения значка | aquamarine |
?color=green |
label |
Надпись на значке | GitMCP |
Documentation |
Пожалуйста, обращайтесь, если вам нужна помощь!
Model Context Protocol — это стандарт, который позволяет ИИ-ассистентам запрашивать и получать дополнительный контекст из внешних источников структурированным образом, улучшая их понимание и производительность.
Да, GitMCP совместим с любым ИИ-ассистентом, поддерживающим Model Context Protocol, включая такие инструменты, как Cursor, VSCode, Claude и другие.
Абсолютно! GitMCP работает с любым публичным репозиторием GitHub без необходимости каких-либо модификаций. Он предпочитает файл llms.txt и переходит к README.md или другим страницам, если первый недоступен. Будущие обновления направлены на поддержку дополнительных методов документации и даже динамическую генерацию контента.
Нет, GitMCP — это бесплатный сервис для сообщества, без каких-либо связанных затрат.
GitMCP глубоко привержен конфиденциальности своих пользователей. Сервис не имеет доступа к какой-либо личной идентифицирующей информации и не хранит ее, поскольку не требует аутентификации. Кроме того, он не хранит никаких запросов, отправленных агентами. Более того, поскольку GitMCP является проектом с открытым исходным кодом, его можно развернуть независимо в вашей среде.
GitMCP обращается только к контенту, который уже является общедоступным, и только при запросе пользователя. GitMCP не выполняет автоматическое сканирование репозиториев. Перед доступом к любому сайту GitHub Pages код проверяет правила robots.txt и следует директивам, установленным владельцами сайтов, позволяя им отказаться от участия. Обратите внимание, что GitMCP не хранит постоянно данные о проектах GitHub или их содержимом.
Мы приветствуем вклад, отзывы и идеи! Пожалуйста, ознакомьтесь с нашими руководством по участию.
Клонируйте репозиторий
bash
git clone https://github.com/idosal/git-mcp.git
cd git-mcp
Установите зависимости
bash
pnpm install
Запустите локально для разработки
bash
npm run dev
# или
pnpm dev
Установите инструмент MCP Inspector:
bash
npx @modelcontextprotocol/inspector
В интерфейсе инспектора:
SSEhttp://localhost:5173/docs)Этот проект лицензирован в соответствии с Лицензией Apache 2.0.
GitMCP предоставляется "как есть" без каких-либо гарантий. Хотя мы стремимся обеспечить надежность и безопасность нашего сервиса, мы не несем ответственности за любые убытки или проблемы, которые могут возникнуть в результате его использования. Проекты GitHub, к которым осуществляется доступ через GitMCP, подчиняются условиям их владельцев. GitMCP не связан с GitHub или какими-либо упомянутыми инструментами ИИ.