# Maplith Bridge

Отдаёт одну папку с файлами данных по MCP за токеном и наполняет её из PostgreSQL под ролью только для чтения. Пароль базы остаётся на вашей машине.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: Maplith
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Maplith/agents
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/maplith-bridge

## Что делает

Bridge работает в вашей сети. Он поднимает MCP-сервер над одной папкой с файлами, доступ закрыт токеном, который вы создаёте сами. Токен пишется в `maplith-bridge.token`, читать его можете только вы. Сервер слушает `http://127.0.0.1:8787/mcp` и только на этой машине.

Наполнение папки идёт из PostgreSQL. Экстрактор отказывается работать под ролью, у которой прав больше, чем чтение, а пароль базы не покидает машину, где он запущен. Рядом с CSV по таблицам появляется `maplith-schema.json`: имена колонок, их типы, ключи и оценка числа строк. Значений там нет. Схема помогает понять, что переименованная колонка — та же самая, а удалённая и созданная заново — новая.

Нужен Node.js 24 или новее. Сервер обходится одним Node.js, у экстрактора одна зависимость — клиент PostgreSQL. В Codex окружение не передаётся серверам плагина, поэтому папку для Bridge там задают отдельно: `npx --yes maplith@1.2.0-rc.1 setup codex --dir <folder>`.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add maplith-bridge -- npx -y maplith
```

### Codex

**Командой платформы**
```bash
codex mcp add maplith-bridge -- npx -y maplith
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maplith-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "maplith"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "maplith-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "maplith"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add maplith-bridge npx -y maplith
```

## Когда брать
- отдать агенту папку с выгрузками, не открывая доступ на запись
- выгрузить таблицы PostgreSQL в CSV под ролью только для чтения
- проверить права роли до первой записи файлов
- показать агенту схему таблиц без самих данных
- подключить базу к агенту, не передавая ему пароль

## Примеры запросов агенту
- Подними Bridge над папкой `./exports` и создай токен
- Выгрузи таблицы из PostgreSQL в `./exports` под ролью `bridge_reader`
- Проверь роль `bridge_reader` через `--check`, файлы пока не пиши

## Похожие
- [mq-bridge](https://affpapa.org/nevibecode/mcp/mq-bridge.md) — MCP-сервер · ★ 25
- [Doc Bridge](https://affpapa.org/nevibecode/mcp/doc-bridge.md) — MCP-сервер · ★ 10
- [DDC/CI Control Bridge](https://affpapa.org/nevibecode/mcp/ddcci-control-bridge.md) — MCP-сервер · ★ 5
- [ArcGIS MCP Bridge](https://affpapa.org/nevibecode/mcp/arcgis-mcp-bridge.md) — MCP-сервер · ★ 23
- [neon-functions](https://affpapa.org/nevibecode/skills/neon-functions.md) — скилл · 27900 установок
- [read-only-local-mysql-mcp-server](https://affpapa.org/nevibecode/mcp/read-only-local-mysql-mcp-server.md) — MCP-сервер · ★ 7

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md