pg-aiguide

pg-aiguide — MCP-сервер сообщества (автор — timescale). Документация и лучшие практики PostgreSQL. Ставится через npx. Доступен и как удалённый сервер. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
timescale
Лицензия
Apache-2.0
Транспорт
stdio, streamable_http
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: medium

Публичный удалённый сервер: запросы уходят в TigerData; к вашей базе не подключается.

Настройка клиентов

codex
{
    "code": "codex mcp add --url \"https://mcp.tigerdata.com/docs\" pg-aiguide",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

pg-aiguide от Timescale даёт ИИ-ассистентам для программирования экспертизу по PostgreSQL. Цель — чтобы агенты писали более качественный код для Postgres: не устаревший, с ограничениями и индексами, с учётом современных возможностей PostgreSQL и практик из реальных проектов.

Проект состоит из трёх частей:

  • Семантический поиск по официальному руководству PostgreSQL с учётом версии.
  • Навыки (skills) — отобранные авторами лучшие практики Postgres. Агенты используют их автоматически.
  • Документация расширений — сейчас TimescaleDB (документация и навыки) и PostGIS (документация). В планах pgvector.

MCP-инструменты:

  • search_docs — единый поиск: семантический (векторное сходство) и по ключевым словам (BM25). Источники: postgres — руководство PostgreSQL по версиям, tiger — документация Tiger Data (TimescaleDB и экосистема), postgis — документация PostGIS.
  • view_skill — навыки по исследованию существующих схем, проектированию схем, стратегиям индексирования, типам данных, ограничениям и целостности, соглашениям об именовании, настройке производительности и современным возможностям PostgreSQL.

В демо из README Claude Code с сервером спроектировал схему для интернет-магазина. В ней было в 4 раза больше ограничений и на 55% больше индексов, включая частичные индексы и индексы по выражениям.

Кому подойдёт

  • Бэкенд-разработчикам: агент проектирует схемы и запросы с учётом актуальной версии PostgreSQL.
  • Командам на TimescaleDB и PostGIS: поиск по документации расширений прямо из агента.
  • Тем, кто разбирается в чужой базе: навык исследования существующей схемы.

Похожие серверы — в категории базы данных.

Установка

MCP-сервер публичный и размещён у TigerData по адресу https://mcp.tigerdata.com/docs — ставить ничего не нужно, достаточно прописать URL в клиенте. Навыки можно поставить отдельно: npx skills add timescale/pg-aiguide --skill postgres. Для Claude Code есть плагин: claude plugin marketplace add timescale/pg-aiguide, затем claude plugin install pg@aiguide. Запуск сервера локально описан в DEVELOPMENT.md репозитория.

Подключение к клиентам

Команды и конфиги приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide

Для VS Code в README есть команда code --add-mcp с тем же URL и типом http. Для OpenCode есть конфиг с типом remote, там же советуют добавлять в запросы use pg-aiguide.

Проверка

Спросите агента о возможности PostgreSQL конкретной версии — должен сработать search_docs со ссылками на руководство.

Примеры задач

Создай схему таблицы Postgres для хранения имён пользователей и уникальных адресов почты.
Спроектируй схему для IoT-датчиков на заводе: температура, влажность, давление, время замера; нужен поиск аномалий и статистика за длительные периоды.

Риски

Сервер только ищет по документации и выдаёт навыки — к вашей базе данных он не подключается. Текст поисковых запросов уходит на внешний сервер TigerData, поэтому не вставляйте в запросы конфиденциальные данные: фрагменты реальных схем с персональными данными, пароли, строки подключения. Код, который предложил агент, проверяйте перед применением к рабочей базе. Лицензия — Apache 2.0.

Частые вопросы

Нужно ли подключать сервер к моей базе?

Нет. pg-aiguide работает с документацией и навыками, доступ к вашей базе ему не нужен.

Чем навыки отличаются от MCP-сервера?

Навыки — готовые инструкции с лучшими практиками, которые агент читает сам. MCP-сервер добавляет поиск по руководствам PostgreSQL, TimescaleDB и PostGIS. Авторы советуют использовать вместе.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники