pg-aiguide — MCP-сервер для Claude Code: документация PostgreSQL
Даёт ИИ-агенту семантический поиск по мануалам PostgreSQL, TimescaleDB и PostGIS и подборки лучших практик, чтобы код был версионно корректным.
claude mcp add --transport http pg-aiguide https://mcp.tigerdata.com/docsЧто делает pg-aiguide
pg-aiguide — публичный MCP-сервер от Timescale. Агент получает доступ к семантическому поиску по официальному мануалу PostgreSQL с учётом версии, по документации TimescaleDB и PostGIS, плюс к набору готовых «скиллов» с проверенными практиками. Всё это подключается к Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline и Zed.
Есть два способа работы. Первый — удалённый HTTP-эндпоинт https://mcp.tigerdata.com/docs, ему не нужны ни ключи, ни локальный запуск. Второй — локальный запуск через npx -y @tigerdata/pg-aiguide в режиме stdio: тогда понадобятся OPENAI_API_KEY и переменные подключения к базе — PGHOST, PGPORT, PGUSER, PGPASSWORD. Без них локальный вариант не стартует, так что для быстрой пробы берите удалённый.
Отдельно репозиторий работает как плагин Claude: он подключает те же скиллы и публичный MCP-эндпоинт. Скиллы можно поставить и без сервера — через npx skills add timescale/pg-aiguide --skill postgres или --skill schema-exploration для разбора существующей базы.
Какие задачи решает
- писать схему БД без устаревших конструкций PostgreSQL
- найти нужный раздел мануала под конкретную версию PG
- добавить ограничения и индексы, которые агент обычно пропускает
- разобрать структуру уже существующей базы
- свериться с документацией TimescaleDB или PostGIS
Примеры запросов агенту
- Опиши схему для интернет-магазина на стандартном PostgreSQL и сохрани в
schema.sql - Найди в мануале PostgreSQL 17, как правильно объявить
GENERATED ALWAYS AS IDENTITY - Изучи существующую базу и покажи, каких индексов не хватает
Как установить pg-aiguide
1Командой платформы: удалённый сервер
claude mcp add --transport http pg-aiguide https://mcp.tigerdata.com/docs2Командой платформы
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env PGHOST=<PGHOST> --env PGPORT=<PGPORT> --env PGUSER=<PGUSER> --env PGPASSWORD=<PGPASSWORD> --transport stdio pg-aiguide -- npx -y @tigerdata/pg-aiguideВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add pg-aiguide --url https://mcp.tigerdata.com/docs2Командой платформы
codex mcp add pg-aiguide --env OPENAI_API_KEY=<OPENAI_API_KEY> --env PGHOST=<PGHOST> --env PGPORT=<PGPORT> --env PGUSER=<PGUSER> --env PGPASSWORD=<PGPASSWORD> -- npx -y @tigerdata/pg-aiguideВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}{
"mcpServers": {
"pg-aiguide": {
"command": "npx",
"args": [
"-y",
"@tigerdata/pg-aiguide"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"PGHOST": "<PGHOST>",
"PGPORT": "<PGPORT>",
"PGUSER": "<PGUSER>",
"PGPASSWORD": "<PGPASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"pg-aiguide": {
"type": "http",
"url": "https://mcp.tigerdata.com/docs"
}
}
}{
"servers": {
"pg-aiguide": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tigerdata/pg-aiguide"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"PGHOST": "<PGHOST>",
"PGPORT": "<PGPORT>",
"PGUSER": "<PGUSER>",
"PGPASSWORD": "<PGPASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http pg-aiguide https://mcp.tigerdata.com/docs2Командой платформы
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e PGHOST=<PGHOST> -e PGPORT=<PGPORT> -e PGUSER=<PGUSER> -e PGPASSWORD=<PGPASSWORD> pg-aiguide npx -y @tigerdata/pg-aiguideВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pg-aiguide
Как установить pg-aiguide в Claude Code?
Подключите удалённый сервер командой claude mcp add --transport http pg-aiguide https://mcp.tigerdata.com/docs. Для локального режима stdio нужна вторая команда с --env для OPENAI_API_KEY, PGHOST, PGPORT, PGUSER, PGPASSWORD и запуском npx -y @tigerdata/pg-aiguide.
Что делает pg-aiguide?
Даёт агенту семантический поиск по мануалам PostgreSQL, TimescaleDB и PostGIS и набор скиллов с практиками Postgres. Агент опирается на них, когда пишет схему или запрос.
Чем удалённый сервер отличается от локального запуска?
Удалённый работает по адресу https://mcp.tigerdata.com/docs и не требует ключей. Локальный через npx -y @tigerdata/pg-aiguide берёт OPENAI_API_KEY и параметры подключения к базе из переменных окружения.
