postgres-mcp — MCP-сервер для Claude Code: обзор и установка
MCP-сервер подключает базу данных PostgreSQL к ИИ-ассистентам для поиска и выполнения SQL-запросов на обычном языке.
claude mcp add postgres-mcp -- docker run -i --rm ghcr.io/pgedge/postgres-mcp:latestЧто делает postgres-mcp
Сервер связывает базы PostgreSQL с ассистентами через протокол MCP по каналам Stdio или HTTP. С ним агент анализирует структуру таблиц, запрашивает системную статистику и переводит вопросы разработчика в готовые SQL-команды. Для выборок доступен гибридный поиск со скорингом BM25 и алгоритмом MMR.
Все пользовательские команды выполняются в транзакциях только для чтения. В репозиторий также входит клиентский чат на языке Go с поддержкой кеширования контекста Anthropic, которое снижает траты на токены до 90%.
Для работы требуется PostgreSQL 14 или старше. Сервер открывает полный доступ к схеме и содержимому таблиц, поэтому создатели запрещают разворачивать его в публичных сервисах без изоляции пользователей.
Какие задачи решает
- выполнять поиск по базе PostgreSQL на естественном языке
- анализировать структуру таблиц и системную статистику
- настроить гибридный текстовый поиск с алгоритмами BM25 и MMR
- диагностировать медленные запросы прямо в окне чата
Примеры запросов агенту
- Покажи структуру таблицы orders и найди пять последних записей
- Выведи статистику сервера и укажи наиболее тяжёлые запросы
- Выполни гибридный поиск по каталогу с ранжированием BM25
Как установить postgres-mcp
Командой платформы
claude mcp add postgres-mcp -- docker run -i --rm ghcr.io/pgedge/postgres-mcp:latestКомандой платформы
codex mcp add postgres-mcp -- docker run -i --rm ghcr.io/pgedge/postgres-mcp:latestФайл настроек
{
"mcpServers": {
"postgres-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/pgedge/postgres-mcp:latest"
]
}
}
}Файл настроек
{
"servers": {
"postgres-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/pgedge/postgres-mcp:latest"
]
}
}
}Командой платформы
gemini mcp add postgres-mcp docker run -i --rm ghcr.io/pgedge/postgres-mcp:latestПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о postgres-mcp
Как установить postgres-mcp в Claude Code?
Выполните команду в терминале: claude mcp add postgres-mcp -- docker run -i --rm ghcr.io/pgedge/postgres-mcp:latest. Для её работы на машине должен быть запущен Docker.
Что делает postgres-mcp?
Он предоставляет моделям инструменты для анализа схемы PostgreSQL, запуска безопасных запросов на чтение и гибридного текстового поиска.
Какие версии PostgreSQL поддерживаются?
Сервер рассчитан на PostgreSQL 14 и выше. По умолчанию все обращения к базе изолированы в транзакциях только для чтения.
