Skip to content
MCP server

Fluxgit MCP Server

Rust Git MCP server with 25 read-only tools and human-approved write proposals

Runs locallyStatus and history
Install
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-sidecar

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools