# Maplith Bridge

Serves one folder of data files over MCP behind a token, and can fill it from PostgreSQL under a read-only role. Your database password stays put.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Maplith
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Maplith/agents
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/maplith-bridge

## What it does

The Bridge runs inside your own network. It puts an MCP server in front of a single folder and gates access with a token you generate yourself. That token lands in `maplith-bridge.token`, readable only by you. The server answers on `http://127.0.0.1:8787/mcp`, on this machine alone.

Filling the folder is the extractor's job. It talks to PostgreSQL and refuses to start under a role that can do anything beyond reading. The database password never leaves the host where the extractor runs. Each table becomes a CSV file, and next to them the extractor writes `maplith-schema.json` with column names, types, keys and an estimated row count. No values go in there. The file lets a reader tell that a renamed column is still the same column, while a dropped and re-added one counts as new.

Node.js 24 or newer is required. The server needs nothing but Node.js; the extractor pulls in one pinned dependency, the PostgreSQL client. Codex does not hand your environment down to plugin servers, so sharing a folder there takes an extra step: `npx --yes maplith@1.2.0-rc.1 setup codex --dir <folder>`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add maplith-bridge -- npx -y maplith
```

### Codex

**Platform CLI**
```bash
codex mcp add maplith-bridge -- npx -y maplith
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maplith-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "maplith"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "maplith-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "maplith"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add maplith-bridge npx -y maplith
```

## When to use it
- hand an agent a folder of exports without granting write access
- dump PostgreSQL tables to CSV under a read-only role
- verify role permissions before any file is written
- show an agent the table schema without the rows
- connect a database to an agent without sharing the password

## Example prompts
- Start the Bridge over `./exports` and create a token
- Extract the PostgreSQL tables into `./exports` as `bridge_reader`
- Run the extractor with `--check` to verify the role, writing nothing

## Similar
- [mq-bridge](https://affpapa.org/en/nevibecode/mcp/mq-bridge.md) — MCP server · ★ 25
- [Doc Bridge](https://affpapa.org/en/nevibecode/mcp/doc-bridge.md) — MCP server · ★ 10
- [DDC/CI Control Bridge](https://affpapa.org/en/nevibecode/mcp/ddcci-control-bridge.md) — MCP server · ★ 5
- [ArcGIS MCP Bridge](https://affpapa.org/en/nevibecode/mcp/arcgis-mcp-bridge.md) — MCP server · ★ 23
- [neon-functions](https://affpapa.org/en/nevibecode/skills/neon-functions.md) — skill · 27900 installs
- [read-only-local-mysql-mcp-server](https://affpapa.org/en/nevibecode/mcp/read-only-local-mysql-mcp-server.md) — MCP server · ★ 7

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md