npm version License: MIT

MCP stdio server exposing git tools to AI clients — status, multi-root inventory, parity checks, presets, logs, pickaxe history search, diffs, commits, push, merge, worktrees, and more. One server process spans every workspace root the client registers at initialize.

Repository: github.com/Rethunk-AI/mcp-multi-root-git · npmjs (manual releases): @rethunk/mcp-multi-root-git · GitHub Packages (CI on each tag): @rethunk-ai/mcp-multi-root-git — see docs/install.md and HUMANS.md#publishing.

Quick start

npx -y @rethunk/mcp-multi-root-git

Full install, prerequisites, and MCP client wiring: HUMANS.md and docs/install.md.

Highlights

Multi-root fan-out — git_status, git_inventory, git_parity, git_log, and git_grep route across one repo, an explicit list, or every MCP root ("*")
Structured JSON — minified tool payloads (format version 7); optional fields omitted when empty
Presets — .rethunk/git-mcp-presets.json at the git toplevel for nested roots and parity pairs
Read and write git — diffs, blame, conflicts, stash, batch_commit, push, merge, cherry-pick, revert, branches, tags, and worktrees (writes take a single workspaceRoot)
Deliberately small surface — 25 tools; every tool must clear the inclusion criteria (enforced policy on writes, fan-out call compression, or large-output compression)
Published schemas — schemas/index.json and per-tool JSON Schema files for offline validation

Documentation

Doc	Audience
docs/install.md	Single source for prerequisites, running the package, and every supported MCP client (plus from-source and troubleshooting)
docs/mcp-tools.md	Tool ids, client naming, JSON shape, resource URI, workspace root resolution (canonical reference)
schemas/index.json	Published JSON schemas for all MCP tool parameters (JSON Schema draft 2020-12 format)
HUMANS.md	Preset file, dev commands, CI, publishing
AGENTS.md	Contributors: implementation map (`src/server/` + entry `src/server.ts`), contract bumps, CI
CONTRIBUTING.md	Dev setup, hooks, commit conventions, release checks, and how to add tools
SECURITY.md	Disclosure policy, threat model, and repository safety guidance
CHANGELOG.md	Release notes (Keep a Changelog style)
specs/README.md	Active / done / parked specification layout used for repo planning