# Maplith Bridge

> Maplith Bridge is an open-source MCP server for databases. Read-only MCP bridge that shares a data folder and fills it from PostgreSQL. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://maplith.com/open-source
- **Repository:** https://github.com/maplith/agents
- **MCP Registry name:** com.maplith/bridge
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-14

## About

The Bridge runs inside your own network and serves one folder of data files to an AI agent, behind a bearer token you generate yourself. It has no write method and accepts no file, and the README says the extractor refuses to run under a database role that can do more than read.

The database password stays on the machine running the extractor; the network-facing server never holds it. The code is small enough to audit, described as six TypeScript files with a single pinned PostgreSQL dependency. It needs Node.js 24 or newer and serves locally at 127.0.0.1:8787/mcp.

It belongs to Maplith, which maps how a company's systems fit together, and the same repository holds a Claude Code and Codex plugin and a relay for waking your own Claude agent. Any MCP client can use the Bridge on its own.

## Features

- **Read-only by design:** The server has no write method and accepts no uploaded file.
- **Local token auth:** Clients send a Bearer token created with the rotate-token command.
- **PostgreSQL extractor:** Fills the shared folder from PostgreSQL under a read-only role.
- **Password stays local:** The database password never reaches the network-facing server.
- **Small codebase:** Four Bridge files plus the setup command, with one pinned dependency.
- **Plugin setup:** maplith setup configures Claude Code or Codex in one command.

## Good for

- Give an agent read access to exported tables without handing over credentials
- Share a folder of CSV or JSON exports with a coding agent
- Let an agent query a snapshot of a Postgres database safely
- Prototype a data-aware agent on a laptop

## Install

### Claude Code (Terminal)

```sh
claude mcp add bridge -- npx -y maplith
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": [
        "-y",
        "maplith"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": [
        "-y",
        "maplith"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "maplith"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": [
        "-y",
        "maplith"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": [
        "-y",
        "maplith"
      ]
    }
  }
}
```

## FAQ

### Does it need Node.js?

Yes, Node.js 24 or newer.

### What licence applies?

The README says everything in the repository is Apache-2.0.

### Can it modify my database?

The README says the extractor refuses a role that can do more than read, and the server has no write method.

### Does it work with non-Maplith agents?

Yes. Any MCP client can connect, including Claude Code, Codex and Claude Desktop.

### Is Maplith Bridge free?

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

### How do I add Maplith Bridge to Claude Code?

Run this command in your terminal: claude mcp add bridge -- npx -y maplith

### What are the best alternatives to Maplith Bridge?

The closest alternatives to Maplith 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/maplith-bridge
