@rethunk/mcp-multi-root-git

<h1 align="center">@rethunk/mcp-multi-root-git</h1>

<div align="center">

  

</div>

---

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) | | TODO.md | Future backlog and planned work | | specs/README.md | Active / done / parked specification layout used for repo planning |

License

Copyright (c) 2026 Rethunk Tech. Licensed under the MIT License — see LICENSE for details.