mcp-server-git: сервер git MCP

Обзор

Сервер Model Context Protocol для взаимодействия и автоматизации репозитория Git. Этот сервер предоставляет инструменты для чтения, поиска и управления репозиториями Git через Large Language Models.

Обратите внимание, что mcp-server-git в настоящее время находится на ранней стадии разработки. Функциональность и доступные инструменты могут быть изменены и расширены по мере того, как мы продолжаем разрабатывать и улучшать сервер.

Инструменты

1. git_status

   • Показывает состояние рабочего дерева

   • Вход:

     • repo_path (строка): Путь к репозиторию Git

   • Возвращает: Текущее состояние рабочего каталога в виде текстового вывода.

2. git_diff_unstaged

   • Показывает изменения в рабочем каталоге, которые еще не были подготовлены

   • Вход:

     • repo_path (строка): Путь к репозиторию Git

   • Возвращает: Дифференциальный вывод неподготовленных изменений

3. git_diff_staged

   • Показывает изменения, подготовленные для фиксации

   • Вход:

     • repo_path (строка): Путь к репозиторию Git

   • Возвращает: Дифференциальный вывод подготовленных изменений

4. git_diff

   • Показывает различия между ветками или коммитами

   • Входные данные:

     • repo_path (строка): Путь к репозиторию Git

     • target (строка): Целевая ветвь или коммит для сравнения

   • Возвращает: Дифференциальный вывод, сравнивающий текущее состояние с целевым.

5. git_commit

   • Записывает изменения в репозиторий

   • Входные данные:

     • repo_path (строка): Путь к репозиторию Git

     • message (строка): сообщение о фиксации

   • Возвращает: подтверждение с новым хешем коммита

6. git_add

   • Добавляет содержимое файла в область подготовки

   • Входные данные:

     • repo_path (строка): Путь к репозиторию Git

     • files (string[]): Массив путей к файлам для подготовки

   • Возврат: Подтверждение размещенных файлов

7. git_reset

   • Отменяет все подготовленные изменения

   • Вход:

     • repo_path (строка): Путь к репозиторию Git

   • Возврат: Подтверждение операции сброса

8. git_log

   • Показывает журналы коммитов

   • Входные данные:

     • repo_path (строка): Путь к репозиторию Git

     • max_count (число, необязательно): максимальное количество отображаемых коммитов (по умолчанию: 10)

   • Возвращает: Массив записей коммитов с хэшем, автором, датой и сообщением.

9. git_create_branch

   • Создает новую ветку

   • Входные данные:

     • repo_path (строка): Путь к репозиторию Git

     • branch_name (string): Имя новой ветки

     • start_point (строка, необязательно): Начальная точка для новой ветви

   • Возврат: Подтверждение создания филиала

10. git_checkout

• Переключает ветви

• Входные данные:

  • repo_path (строка): Путь к репозиторию Git

  • branch_name (string): Название филиала для оформления заказа

• Возврат: Подтверждение смены филиала

11. git_show

• Показывает содержимое коммита

• Входные данные:

  • repo_path (строка): Путь к репозиторию Git

  • revision (строка): ревизия (хэш коммита, имя ветки, тег), которую нужно показать

• Возвращает: содержимое указанного коммита.

12. git_init

• Инициализирует репозиторий Git

• Входные данные:

  • repo_path (строка): Путь к каталогу для инициализации репозитория git

• Возвращает: Подтверждение инициализации репозитория.

Установка

Использование УФ (рекомендуется)

При использовании uv не требуется специальной установки. Мы будем использовать uvx для прямого запуска mcp-server-git .

Использование PIP-картинки

В качестве альтернативы вы можете установить mcp-server-git через pip:

После установки вы можете запустить его как скрипт, используя:

Конфигурация

Использование с Claude Desktop

Добавьте это в ваш claude_desktop_config.json :

• Примечание: замените «/Users/имя_пользователя» на путь, который должен быть доступен этому инструменту.

Использование с VS Code

Для быстрой установки используйте одну из кнопок установки в один клик ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

Для установки Docker:

Использование с Zed

Добавьте в ваш Zed settings.json:

Отладка

Вы можете использовать MCP inspector для отладки сервера. Для установок uvx:

Или, если вы установили пакет в определенный каталог или ведете в нем разработку:

Выполнение tail -n 20 -f ~/Library/Logs/Claude/mcp*.log покажет журналы с сервера и может помочь вам устранить любые неполадки.

Разработка

Если вы занимаетесь локальной разработкой, есть два способа протестировать ваши изменения:

1. Запустите инспектор MCP для проверки изменений. Инструкции по запуску см. в разделе Отладка .

2. Тестируйте с помощью приложения Claude для рабочего стола. Добавьте следующее в ваш claude_desktop_config.json :

Докер

UVX

Строить

Сборка Docker:

Лицензия

Этот сервер MCP лицензи��ован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.