Postgres MCP (Ushurbakiyev Davlat)

PostgreSQL MCP Server

Read-only MCP-сервер для PostgreSQL. Даёт Claude доступ к базе данных для анализа схемы, выполнения SELECT-запросов и диагностики производительности.

Поддерживает named connections (несколько баз одновременно), dual transport (SSE для Cowork + Streamable HTTP для Claude Code CLI) и деплой на VPS с nginx + systemd.

Инструменты (Tools)

Named Connections

Сервер поддерживает несколько баз одновременно через connections.json. Переключение прямо в чате — без рестарта.

Создай файл connections.json рядом с dist/:

{
  "connections": {
    "knowledge": {
      "url": "postgres://user:password@localhost:5432/knowledge",
      "description": "Knowledge base (RAG)"
    },
    "shopdb": {
      "url": "postgres://user:password@localhost:5432/shopdb",
      "description": "Production shop DB"
    }
  },
  "default": "default"
}

Переключение в чате:

pg_use_connection("shopdb")

Безопасность

• Только чтение: INSERT, UPDATE, DELETE, DROP, ALTER и другие write-операции заблокированы
• Таймаут: Каждый запрос ограничен 30 секундами
• Лимит строк: По умолчанию 100 строк, максимум 1000
• Token auth: Все эндпоинты защищены Bearer-токеном через nginx

Установка и сборка

cd postgres-mcp-server
npm install
npm run build

Подключение — Cowork (SSE transport)

claude mcp add --transport sse postgres-mcp "https://YOUR_DOMAIN/sse?token=YOUR_TOKEN"

Подключение — Claude Code CLI (Streamable HTTP)

claude mcp add --transport http postgres-mcp "https://YOUR_DOMAIN/mcp?token=YOUR_TOKEN"

Подключение — локально (stdio)

Добавь в ~/.claude/settings.json:

{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "node",
      "args": ["/ПОЛНЫЙ/ПУТЬ/К/postgres-mcp-server/dist/index.js"]
    }
  }
}

При использовании connections.json переменная DATABASE_URL не нужна — базы берутся из файла.

Деплой на VPS (Hetzner + nginx + systemd)

Структура на сервере

/opt/PostgresMCP/
  dist/          ← собранный JS
  connections.json
  node_modules/

systemd unit (/etc/systemd/system/postgres-mcp.service)

[Unit]
Description=PostgreSQL MCP Server
After=network.target

[Service]
WorkingDirectory=/opt/PostgresMCP
ExecStart=/usr/bin/node dist/index.js
Restart=always
Environment=PORT=3200

[Install]
WantedBy=multi-user.target

nginx — fragment (/etc/nginx/sites-available/postgres-mcp)

server {
    listen 443 ssl;
    server_name YOUR_DOMAIN;

    location /sse {
        proxy_pass http://localhost:3200;
        proxy_buffering off;
        proxy_cache off;
        proxy_set_header Connection '';
        chunked_transfer_encoding on;
    }

    location /mcp {
        proxy_pass http://localhost:3200;
    }

    # /messages — без token-check, sessionId достаточен
    location /messages {
        proxy_pass http://localhost:3200;
    }
}

Деплой обновлений

# Локально
git add . && git commit -m "..." && git push

# На VPS
cd /opt/PostgresMCP && git pull && npm run build && systemctl restart postgres-mcp

Управление сервисом

systemctl status postgres-mcp      # статус
systemctl restart postgres-mcp     # перезапуск
journalctl -u postgres-mcp -f      # логи в реальном времени

Использование

После подключения Claude автоматически видит инструменты. Примеры:

• "Покажи все доступные базы данных"
• "Переключись на базу shopdb"
• "Покажи все таблицы в базе"
• "Опиши структуру таблицы users"
• "Найди дубликаты email в таблице customers"
• "Почему запрос SELECT * FROM orders WHERE status = 'pending' медленный?"
• "Какие индексы не используются в таблице products?"

Разработка

# Запуск в dev-режиме
npm run dev

# Сборка
npm run build