Fluxgit MCP Server
Rust Git MCP server with 25 read-only tools and human-approved write proposals
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- 1 day ago
About Fluxgit MCP Server
Fluxgit MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The server splits Git work into inspection and consent. It exposes 25 read-only tools, 15 of which work with plain git and need no app, plus 13 operation tools: twelve submit proposals and one cancels a pending one. It never performs a Git write itself. A proposal goes to the FluxGit desktop app, which shows a preview, risk and recovery context, and the operation runs only after a person approves. Approvals and results are logged locally, with Ed25519 signing when enabled.
Useful reads include repo.brief for one-call situational awareness, repo.scope for monorepo subtrees, conflict.read for active conflicts as structured data, worktree.list, diff.semantic with documented fallbacks, fleet.radar and fleet.digest across repositories, and a reflog and restore-point timeline. Tools needing the app return an explicit error code instead of a guess.
The maintainers state a limit: if the host also gives the agent a shell, it can run git directly, which FluxGit can only record through a hook. The loop is beta; interactive rebase is not yet supported and results are polled. Licensed Apache-2.0.
Install
Run in a terminal
claude mcp add fluxgit-mcp-server -- npx -y fluxgit-mcp-sidecarAdd to claude_desktop_config.json
{
"mcpServers": {
"fluxgit-mcp-server": {
"command": "npx",
"args": [
"-y",
"fluxgit-mcp-sidecar"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fluxgit-mcp-server": {
"command": "npx",
"args": [
"-y",
"fluxgit-mcp-sidecar"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fluxgit-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fluxgit-mcp-sidecar"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fluxgit-mcp-server": {
"command": "npx",
"args": [
"-y",
"fluxgit-mcp-sidecar"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fluxgit-mcp-server": {
"command": "npx",
"args": [
"-y",
"fluxgit-mcp-sidecar"
]
}
}
}Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- repo.brief
- One-call situational awareness for a repository.
- repo.scope
- Scopes one subtree of a monorepo.
- repo.status
- Working tree and current branch status.
- repo.refs
- Branches, tags, remotes and stashes.
- repo.branchStack
- Current branch versus upstream and base.
- repo.history
- Paginated commit history.
- repo.reflog
- Movement timeline with recovery hints.
- repo.conflictPreflight
- Predict merge or rebase outcome.
- conflict.read
- Active conflict as structured data.
- commit.details
- Single commit metadata and changed files.
- worktree.changes
- Per-path working tree changes.
- worktree.list
- Lists worktrees.
- submodule.status
- Submodule list and state.
- diff.text
- Standard text patch.
- diff.semantic
- Semantic diff explanation.
- fleet.radar
- Multi-repo attention queue.
- fleet.digest
- What changed across repositories since a time.
What it does
- Situational brief
- repo.brief replaces several raw git calls in one budgeted answer.
- Structured conflicts
- conflict.read returns base, ours, theirs and marker regions.
- Propose-approve writes
- Writes become proposals a person approves in the app.
- Multi-repo awareness
- fleet.radar and fleet.digest summarise many repositories.
- Restore points
- Safety tools expose timelines and restore points.
- Signed audit log
- Records proposals and results locally.
Good for
- Have an agent explain branch state and recent history
- Read an active merge conflict as structured data
- Let an agent propose a merge or push for human approval
- Summarise what changed across several repositories
- Predict merge outcomes before running them
Pricing
Open source
Apache-2.0 server; write approvals need the FluxGit desktop app
Prices change. Check fluxgit.com before you buy.
Fluxgit MCP Server FAQ
Can the agent write to Git through it?
No. It can only submit proposals, which run after a person approves in the FluxGit app.
Does it work without the app?
Standard inspection tools do; app-dependent tools return an explicit hint.
What are its limits?
If the host gives the agent a shell, git can still be run directly; interactive rebase is not yet supported.
What is the licence?
Apache-2.0.
Is Fluxgit MCP Server free?
Yes. Fluxgit MCP Server is open source, so you can use and self-host it for free.
How do I add Fluxgit MCP Server to Claude Code?
Run this command in your terminal: claude mcp add fluxgit-mcp-server -- npx -y fluxgit-mcp-sidecar
What are the best alternatives to Fluxgit MCP Server?
The closest alternatives to Fluxgit MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Fluxgit MCP Server

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools