# mqb · mq-bridge

> mqb · mq-bridge is an open-source MCP server for databases. Move data between 15+ databases, queues and files without rows entering context. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://marcomq.github.io/mq-bridge/MCP.html
- **Repository:** https://github.com/marcomq/mq-bridge/tree/HEAD/apps/mq-bridge-app
- **MCP Registry name:** io.github.marcomq/mq-bridge
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mqb-mq-bridge
