mcpg — MCP-сервер для Claude Code: PostgreSQL-инструменты и установка
MCP-сервер с 254 инструментами для PostgreSQL: запросы, настройка производительности, операции. По умолчанию работает в режиме только для чтения.
claude mcp add mcpg -- uvx mcpgЧто делает mcpg
Сервер подключает агента к базе PostgreSQL через 254 инструмента. Внутри — прямая работа через psycopg3, поддержка TimescaleDB, pgvector, PostGIS, Apache AGE и pg_stat_statements, если они есть в вашей базе. Инструменты охватывают интроспекцию каталога, построение SQL из естественного языка, гибридный поиск, графовые запросы, анализ производительности и миграции. Режим read-only включён по умолчанию, каждый SQL-запрос проходит валидацию через AST.
Установка через pip install mcpg или uvx mcpg, для Docker — образ ghcr.io/devopam/mcpg:latest. Сервер работает через stdio и HTTP/SSE, в HTTP-режиме отдаёт /metrics для Prometheus. Поддерживает PostgreSQL 14–19 (бета), пулинг соединений, роутинг запросов на реплики для чтения, многопользовательский режим через SET ROLE, аудит с редакцией учётных данных.
Для работы нужна база PostgreSQL и переменная окружения MCPG_DATABASE_URL с адресом подключения. Без psycopg3 в окружении pip сервер не запустится.
Какие задачи решает
- написать SQL-запрос из описания на естественном языке
- проверить загрузку индексов и найти узкие места через EXPLAIN
- получить схему таблицы или весь каталог базы данных
- запустить гибридный поиск или графовый запрос по данным
- отследить блокировки, активные запросы и здоровье реплик
Примеры запросов агенту
- Подключи сервер
mcpgи покажи схему таблицыorders - Через
mcpgпострой SQL-запрос: последние 50 заказов за этот месяц - Запусти
EXPLAIN ANALYZEдля запроса из файлаslow_query.sqlчерезmcpg
Как установить mcpg
Командой платформы
claude mcp add mcpg -- uvx mcpguvx запускает команду с именем пакета; если в README она другая — uvx --from mcpg <команда>
Командой платформы
codex mcp add mcpg -- uvx mcpguvx запускает команду с именем пакета; если в README она другая — uvx --from mcpg <команда>
Файл настроек
{
"mcpServers": {
"mcpg": {
"command": "uvx",
"args": [
"mcpg"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpg <команда>
Файл настроек
{
"servers": {
"mcpg": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpg"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpg <команда>
Командой платформы
gemini mcp add mcpg uvx mcpguvx запускает команду с именем пакета; если в README она другая — uvx --from mcpg <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcpg
Как установить mcpg в Claude Code?
Выполни claude mcp add mcpg -- uvx mcpg в терминале. Claude Code добавит сервер в конфиг и запустит его через uvx.
Что делает mcpg?
Подключает агента к PostgreSQL через 254 инструмента для запросов, интроспекции, настройки производительности и операций. По умолчанию работает только на чтение, каждый SQL-запрос проверяется через AST.
Какие версии PostgreSQL поддерживает mcpg?
PostgreSQL 14, 15, 16, 17, 18 протестированы в CI. Версия 19 (бета) работает экспериментально.
