MCP-сервер для PostgreSQL

Производственно-ориентированный MCP-сервер для PostgreSQL, предоставляющий операции с базой данных MCP-клиентам (Claude Desktop, VS Code Copilot, Cursor и совместимые хосты).

Возможности

• Выполнение запросов (SELECT, INSERT, UPDATE, DELETE)

• Обнаружение баз данных и интроспекция схем

• Просмотр метаданных таблиц (столбцы, типы, допустимость NULL, значения по умолчанию, первичные ключи)

• Обнаружение индексов и внешних ключей

• Конфигурация через переменные окружения для безопасного развертывания

Related MCP server: Azure Database for PostgreSQL MCP Server

Доступные инструменты

Требования

• Node.js 18+

• Доступ к экземпляру PostgreSQL

• Сетевая связь от MCP-хоста до PostgreSQL (host:port)

Конфигурация

Установите параметры подключения с помощью переменных окружения:

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

Запуск напрямую из GitHub

npx github:ferronicardoso/mcp-postgresql

Claude Code (CLI)

claude mcp add postgresql --scope user -- npx -y github:ferronicardoso/mcp-postgresql

--scope управляет тем, где хранится регистрация сервера:

Переменные окружения можно передать с помощью повторяющихся флагов --env KEY=VALUE перед --, например:

Bash (Linux/macOS/WSL):

claude mcp add postgresql --scope user \
  --env PGHOST=localhost \
  --env PGPORT=5432 \
  --env PGDATABASE=postgres \
  --env PGUSER=postgres \
  --env PGPASSWORD=your-password \
  -- npx -y github:ferronicardoso/mcp-postgresql

PowerShell:

claude mcp add postgresql --scope user `
  --env PGHOST=localhost `
  --env PGPORT=5432 `
  --env PGDATABASE=postgres `
  --env PGUSER=postgres `
  --env PGPASSWORD=your-password `
  -- npx -y github:ferronicardoso/mcp-postgresql

Codex CLI

Bash (Linux/macOS/WSL):

codex mcp add postgresql \
  --env PGHOST=localhost \
  --env PGPORT=5432 \
  --env PGDATABASE=postgres \
  --env PGUSER=postgres \
  --env PGPASSWORD=your-password \
  npx -- -y github:ferronicardoso/mcp-postgresql

PowerShell:

codex mcp add postgresql `
  --env PGHOST=localhost `
  --env PGPORT=5432 `
  --env PGDATABASE=postgres `
  --env PGUSER=postgres `
  --env PGPASSWORD=your-password `
  npx -- -y github:ferronicardoso/mcp-postgresql

Это регистрирует сервер в ~/.codex/config.toml. Чтобы удалить его, выполните codex mcp remove postgresql.

Конфигурация Claude Desktop

%APPDATA%\\Claude\\claude_desktop_config.json:

{
  "mcpServers": {
    "postgresql": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-postgresql"],
      "env": {
        "PGHOST": "localhost",
        "PGPORT": "5432",
        "PGDATABASE": "postgres",
        "PGUSER": "postgres",
        "PGPASSWORD": "your-password"
      }
    }
  }
}

Конфигурация MCP в VS Code

.vscode/mcp.json:

{
  "servers": {
    "postgresql": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-postgresql"],
      "env": {
        "PGHOST": "localhost",
        "PGPORT": "5432",
        "PGDATABASE": "postgres",
        "PGUSER": "postgres",
        "PGPASSWORD": "your-password"
      }
    }
  }
}

Запуск с Docker (HTTP-транспорт)

Опубликованный образ по умолчанию работает в режиме Streamable HTTP, для использования в качестве удаленной MCP-конечной точки (например, из узла MCP Client Tool в n8n или любого совместимого клиента Streamable HTTP):

Bash (Linux/macOS/WSL):

docker run -d --name mcp-postgresql \
  -p 3002:3002 \
  -e PGHOST=host.docker.internal \
  -e PGPORT=5432 \
  -e PGDATABASE=postgres \
  -e PGUSER=postgres \
  -e PGPASSWORD=your-password \
  ghcr.io/ferronicardoso/mcp-postgresql:latest

PowerShell:

docker run -d --name mcp-postgresql `
  -p 3002:3002 `
  -e PGHOST=host.docker.internal `
  -e PGPORT=5432 `
  -e PGDATABASE=postgres `
  -e PGUSER=postgres `
  -e PGPASSWORD=your-password `
  ghcr.io/ferronicardoso/mcp-postgresql:latest

MCP-конечная точка становится доступна по адресу http://localhost:3002/mcp.

Локальная разработка

git clone https://github.com/ferronicardoso/mcp-postgresql
cd mcp-postgresql
npm install
npm run build

Запустите скомпилированный сервер:

npm start

Процесс сборки и коммитов

Этот репозиторий намеренно отслеживает dist/, чтобы поддерживать использование npx github:user/repo.

Проект использует Husky-хук pre-commit для:

1. сборки TypeScript (npm run build)

2. добавления сгенерированных артефактов в индекс (git add dist)

Ручной аналог:

npm run build
git add dist

Замечания по безопасности

• Никогда не коммитьте реальные учетные данные или файлы .env.

• Для производственного использования предпочитайте пользователей базы данных с минимальными привилегиями.

• Для публичных или ненадежных сетей включите шифрование (PGSSL=true) и настройте соответствующие сертификаты.

Лицензия

MIT © Raphael Augusto Ferroni Cardoso