# Postgres and REST twins

MCP-сервер Postgres and REST twins для Claude Code поднимает локальные двойники Postgres и REST. Он подключается к схеме SQL или спецификации OpenAPI и отклоняет запросы за пределами заданного контракта.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: cmdrvl
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cmdrvl/twinning
- Обновлён: 2026-11-13
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/postgres-and-rest-twins

## Что делает

Сервер создаёт локальные двойники базы Postgres и REST API по схеме или спецификации OpenAPI. Клиент подключается к ним обычным драйвером, а запись с нарушением ограничения получает SQLSTATE и причину отказа. Сервер сохраняет отчёт о запросах.

Двойник Postgres принимает только объявленное подмножество SQL, а REST обслуживает маршруты из спецификации. Запросы вне контракта отклоняются, а не получают предположительный ответ. Можно прогнать набор запросов на старом и новом снимках Postgres и сравнить результаты миграции.

Для установки через `npx` нужен этот пакетный запускатель; готовый сервер доступен для macOS и Linux, а архив Windows не содержит MCP-сервер.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add twinning -- npx -y @cmdrvl/twinning-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add postgres-and-rest-twins -- npx -y @cmdrvl/twinning-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postgres-and-rest-twins": {
            "command": "npx",
            "args": [
                "-y",
                "@cmdrvl/twinning-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "postgres-and-rest-twins": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cmdrvl/twinning-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add postgres-and-rest-twins npx -y @cmdrvl/twinning-mcp
```

## Когда брать
- проверить обработку ограничений схемы при разработке загрузчика данных
- сравнить результаты запросов на старой и новой версиях базы
- протестировать REST-клиент по контракту OpenAPI

## Примеры запросов агенту
- Подними двойник Postgres по схеме `schema.sql` и покажи причины отказа для записей, нарушающих ограничения.
- Сравни результаты набора запросов на старом и новом снимках Postgres.
- Проверь REST-клиент на соответствие спецификации OpenAPI и покажи отказы по схеме.

## Похожие
- [prisma-postgres](https://affpapa.org/nevibecode/skills/prisma-postgres.md) — скилл · 431100 установок
- [prisma-postgres-setup](https://affpapa.org/nevibecode/skills/prisma-postgres-setup.md) — скилл · 425700 установок
- [neon-postgres-branches](https://affpapa.org/nevibecode/skills/neon-postgres-branches.md) — скилл · 37300 установок
- [neon-postgres-egress-optimizer](https://affpapa.org/nevibecode/skills/neon-postgres-egress-optimizer.md) — скилл · 35100 установок
- [postgres-pro](https://affpapa.org/nevibecode/skills/postgres-pro.md) — скилл · 8400 установок
- [postgres-patterns](https://affpapa.org/nevibecode/skills/postgres-patterns.md) — скилл · 7200 установок

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