Skip to content
MCP server

MELRA

Local MCP runtime that checks, approves and records every agent tool call

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0-alpha.14
Listing updated
2 days ago

About MELRA

MELRA is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

MELRA sits between an agent and the tools it calls. Each call routed through it is checked against a local policy and then allowed, refused before anything runs, or held for a person's exact approval. A call counts as done only if the evidence it declared holds, and the outcome is stored as a redacted receipt linked by hash.

For each task, MELRA dispatches a mutation at most once. If the outcome is uncertain it parks the call for reconciliation instead of replaying it, and the README notes that exactly-once effects still depend on the provider. Calls made through other tools are outside its control. The project is labelled alpha, so APIs may change before 1.0, and the authors advise an isolated workspace with narrow domain and command allowlists.

Setup is one command, npx @melra/cli@alpha setup, which writes a local policy, detects installed agent apps, and writes MELRA into the one you pick, saving a .bak first. It needs Node.js 22.13 or newer, and a Docker image and prebuilt releases exist. MELRA is built by XAGI Labs, which also makes a personal agent called Bhai that routes its sends through it.

Install

Run in a terminal

claude mcp add melra -- npx -y @melra/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "melra": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}

What it does

Policy checks
Every call is allowed, refused or held for approval.
Human approvals
Risky changes wait for a person to approve the exact action.
Verified results
An action is done only when the declared evidence holds.
Hash-linked receipts
Each action ends in a redacted, durable record.
At-most-once dispatch
Uncertain outcomes are parked, not replayed.
Guided setup
One command configures a policy and your MCP client.

Good for

  • Gate an agent's file and shell actions behind approvals
  • Keep an audit trail of what an agent did
  • Stop duplicate sends after a timeout
  • Limit an agent to an allowlist of domains and commands

Pricing

Open source

Open source; alpha release

Prices change. Check xagilab.com before you buy.

MELRA FAQ

Is it production ready?

No. The README labels it alpha and says APIs may change before 1.0.

What do I need to run it?

Node.js 22.13 or newer, or 23.4 or newer, or the Docker image.

Does it control every tool my agent uses?

No. Only calls routed through MELRA are governed.

How do I install it?

Run npx @melra/cli@alpha setup in the project folder.

Is MELRA free?

Yes. MELRA is open source, so you can use and self-host it for free.

How do I add MELRA to Claude Code?

Run this command in your terminal: claude mcp add melra -- npx -y @melra/cli

What are the best alternatives to MELRA?

The closest alternatives to MELRA are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to MELRA

  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