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; к вашей базе не подключается.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.