git MCP-сервер

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

Обзор

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

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

Инструменты

git_status
- Показывает состояние рабочего дерева
- Вход:
  - repo_path (строка): Путь к репозиторию Git
- Возвращает: Текущее состояние рабочего каталога в виде текстового вывода.
git_diff_unstaged
- Показывает изменения в рабочем каталоге, которые еще не были подготовлены
- Вход:
  - repo_path (строка): Путь к репозиторию Git
- Возвращает: Дифференциальный вывод неподготовленных изменений
git_diff_staged
- Показывает изменения, подготовленные для фиксации
- Вход:
  - repo_path (строка): Путь к репозиторию Git
- Возвращает: Дифференциальный вывод подготовленных изменений
git_diff
- Показывает различия между ветками или коммитами
- Входные данные:
  - repo_path (строка): Путь к репозиторию Git
  - target (строка): Целевая ветвь или коммит для сравнения
- Возвращает: Дифференциальный вывод, сравнивающий текущее состояние с целевым.
git_commit
- Записывает изменения в репозиторий
- Входные данные:
  - repo_path (строка): Путь к репозиторию Git
  - message (строка): сообщение о фиксации
- Возвращает: подтверждение с новым хешем коммита
git_add
- Добавляет содержимое файла в область подготовки
- Входные данные:
  - repo_path (строка): Путь к репозиторию Git
  - files (string[]): Массив путей к файлам для подготовки
- Возврат: Подтверждение размещенных файлов
git_reset
- Отменяет все подготовленные изменения
- Вход:
  - repo_path (строка): Путь к репозиторию Git
- Возврат: Подтверждение операции сброса
git_log
- Показывает журналы коммитов
- Входные данные:
  - repo_path (строка): Путь к репозиторию Git
  - max_count (число, необязательно): максимальное количество отображаемых коммитов (по умолчанию: 10)
- Возвращает: Массив записей коммитов с хэшем, автором, датой и сообщением.
git_create_branch
- Создает новую ветку
- Входные данные:
  - repo_path (строка): Путь к репозиторию Git
  - branch_name (string): Имя новой ветки
  - start_point (строка, необязательно): Начальная точка для новой ветви
- Возврат: Подтверждение создания филиала
git_checkout

Переключает ветви
Входные данные:
- repo_path (строка): Путь к репозиторию Git
- branch_name (string): Название филиала для оформления заказа
Возврат: Подтверждение смены филиала

git_show

Показывает содержимое коммита
Входные данные:
- repo_path (строка): Путь к репозиторию Git
- revision (строка): ревизия (хэш коммита, имя ветки, тег), которую нужно показать
Возвращает: содержимое указанного коммита.

git_init

Инициализирует репозиторий Git
Входные данные:
- repo_path (строка): Путь к каталогу для инициализации репозитория git
Возвращает: Подтверждение инициализации репозитория.

Установка

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

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

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

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

pip install mcp-server-git

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

python -m mcp_server_git

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

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

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

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}

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

"mcpServers": {
  "git": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
  }
}

"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}

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

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

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

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

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

{
  "mcp": {
    "servers": {
      "git": {
        "command": "uvx",
        "args": ["mcp-server-git"]
      }
    }
  }
}

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

{
  "mcp": {
    "servers": {
      "git": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "--mount", "type=bind,src=${workspaceFolder},dst=/workspace",
          "mcp/git"
        ]
      }
    }
  }
}

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

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

"context_servers": [
  "mcp-server-git": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-git"]
    }
  }
],

"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},

Отладка

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

npx @modelcontextprotocol/inspector uvx mcp-server-git

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

cd path/to/servers/src/git
npx @modelcontextprotocol/inspector uv run mcp-server-git

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

Разработка

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

Запустите инспектор MCP для проверки изменений. Инструкции по запуску см. в разделе Отладка .
Тестируйте с помощью приложения Claude для рабочего стола. Добавьте следующее в ваш claude_desktop_config.json :

Докер

{
  "mcpServers": {
    "git": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/git"
      ]
    }
  }
}

UVX

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
  }
}

Строить

Сборка Docker:

cd src/git
docker build -t mcp/git .

Лицензия

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

git MCP server

Integrations

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

Обзор

Инструменты

Установка

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

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

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

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

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

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

Отладка

Разработка

Докер

UVX

Строить

Лицензия

Tools

Related MCP Servers

Git MCP Server

Github MCP Server

GitHub MCP Server

Git Prompts MCP Server

Appeared in Searches

New MCP Servers