Skip to main content
Glama
ShinonomeAya

git-graph-mcp

by ShinonomeAya

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: worktree-map

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

Требования: 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

Подробнее:

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    B
    maintenance
    MCP server that visualizes git branch genealogy and worktree locations within a repository, marking the current session position. Supports creating branches/worktrees, safe deletion/cleanup, and session navigation with fallback guidance.
    2
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    A local git MCP server. It exposes 12 git operations to an MCP client over stdio, allowing the client to inspect and work with a git repository on your machine, including status, diffs, log, branches, staging, and commits.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables people and AI agents to query local code repositories as graphs through stdio MCP tools for project listing, search, dependency tracing, impact analysis, bridge detection, node inspection, bounded code reading, and optional LSP definition/reference lookups.
    MIT