git-graph-mcp

Локально-ориентированный терминальный инструмент для графа коммитов Git, который также предоставляет стандартный MCP stdio-сервис. Он позволяет выбирать коммиты или диапазоны в терминале, а затем даёт MCP-клиентам, таким как Claude Code, Codex, Cursor, читать тот же ограниченный бюджетом контекст Git.

Возможности

• Просматривайте в терминале граф коммитов, ветки, детали коммитов и состояние рабочей области;

• Сохраняйте выбор commit, range, ref и повторно используйте его между CLI/TUI/MCP;

• Читайте через MCP graph, status, context, search, diff, history и resources;

• Генерируйте безопасные операции с ветками и предпросмотр reset, не выполняя автоматически reset/checkout/push;

• Проверяйте Node.js, Git, репозиторий, конфигурацию MCP и рукопожатие stdio с помощью doctor.

Related MCP server: org-as-code MCP Server

Быстрый старт

Требования: Git в PATH, официальная поддержка Node.js 22+.

npm ci
node .\bin\git-graph-mcp.js graph --plain --limit 8
node .\bin\git-graph-mcp.js doctor

Интерактивный TUI:

node .\bin\git-graph-mcp.js graph

Часто используемые операции:

node .\bin\git-graph-mcp.js status
node .\bin\git-graph-mcp.js search --limit 20
node .\bin\git-graph-mcp.js select commit <commit-oid>
node .\bin\git-graph-mcp.js selected
node .\bin\git-graph-mcp.js doctor --json

Если целевой репозиторий не является текущим каталогом, добавьте к команде --repo <path>.

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

.mcp.json в корне репозитория использует локальный stdio:

{
  "mcpServers": {
    "git-graph": {
      "type": "stdio",
      "command": "node",
      "args": ["./bin/git-graph-mcp.js", "mcp"]
    }
  }
}

Сервер предоставляет 12 ограниченных инструментов и два ресурса только для чтения: git-graph://default/selection, git-graph://default/status. MCP stdout содержит только сообщения протокола; диагностика записывается в stderr и не раскрывает пути репозитория, значения конфигурации или содержимое запросов.

Границы безопасности

Рабочий процесс по умолчанию доступен только для чтения. Создание ветки требует явного вызова и не перемещает существующие ветки; reset только создаёт предпросмотр, а git_revalidate_plan проверяет отпечаток состояния репозитория перед действием. Проект не запускает сетевые слушатели, не загружает содержимое репозитория.

Разработка и публикация

npm run check
npm run test:package-install

Подробнее:

• Пятиминутное демо

• Возможности и тестовые доказательства

• Руководство по внесению вклада

• Политика безопасности

• Контрольный список релиза