Skip to content
MCP server

mqb · mq-bridge

Move data between 15+ databases, queues and files without rows entering context

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.6.1
Listing updated
3 days ago

About mqb · mq-bridge

mqb · mq-bridge is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.

The idea here is that the agent describes the job and the engine moves the bytes. Endpoints are passed inline as JSON keyed by connector type, so nothing is preconfigured and no YAML is needed. The docs give an example of a 116.3 MiB dataset moved in three tool calls and about 385 tokens, and say the cost stays the same for 1,000 rows or 1,000,000.

The server is the MCP mode of the mqb app, a Rust ETL and messaging tool. It runs over stdio for local clients or streamable HTTP for shared ones, and 'mqb mcp install' registers it with detected clients. It offers 11 tools, or 13 with the optional agent bus enabled.

A routes tool can also render any route as a headless mqb command with credentials swapped for environment variable placeholders, so a one-off job can become a repeatable one.

Install

Run in a terminal

claude mcp add mq-bridge -- docker run -i --rm ghcr.io/marcomq/mq-bridge-app:1.6.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mq-bridge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/marcomq/mq-bridge-app:1.6.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mq-bridge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/marcomq/mq-bridge-app:1.6.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mq-bridge": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/marcomq/mq-bridge-app:1.6.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mq-bridge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/marcomq/mq-bridge-app:1.6.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mq-bridge": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/marcomq/mq-bridge-app:1.6.1"
      ]
    }
  }
}

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

publish
Send one message or a batch to any endpoint
start_route
Run a route moving messages from source to sink
generate_cli_command
Render a route as a copyable headless mqb command
describe
List connector types and middlewares with config fields
list_routes
List routes with live health and rates
route_status
Health, totals and rates for one or all routes
wait_route
Block until a route finishes and report how it ended
route_messages
Read the most recent captured messages on a route
stop_route
Stop a route and return totals
bridge_status
List mq-bridge processes on this machine
server_info
Report version, build details and agent bus state

What it does

Inline endpoints
Source and sink are given as JSON, with no config files.
Route lifecycle
Start, monitor, wait for and stop routes from the agent.
CLI command export
Renders a route as a headless command with credential placeholders.
Message capture
Reads recent messages from a route when capture is requested.
Two transports
Runs over stdio or streamable HTTP.
Optional agent bus
Adds listen and send tools for agent messaging.

Good for

  • Drain a Redis stream into a Postgres table
  • Copy data between queues and databases from a chat
  • Inspect messages passing through a route
  • Turn an ad hoc transfer into a scripted command

Pricing

Open source

Distributed as binaries, Docker image and cargo crate; pricing not published

Prices change. Check marcomq.github.io before you buy.

mqb · mq-bridge FAQ

How is it installed?

Through Homebrew, Docker, cargo or binaries; 'mqb mcp install' registers it with MCP clients.

Do I need to write config first?

No. Endpoints are passed inline when a route starts.

How many connectors?

The docs say 15+.

Which transports are available?

stdio by default and streamable HTTP with --transport http.

Is mqb · mq-bridge free?

Yes. mqb · mq-bridge is open source, so you can use and self-host it for free.

How do I add mqb · mq-bridge to Claude Code?

Run this command in your terminal: claude mcp add mq-bridge -- docker run -i --rm ghcr.io/marcomq/mq-bridge-app:1.6.1

What are the best alternatives to mqb · mq-bridge?

The closest alternatives to mqb · mq-bridge are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to mqb · mq-bridge

  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