pg-aiguide

pg-aiguide

timescaleApache-2.0
1.8k звёзд94 форков
pg-aiguide — это MCP-сервер для разработчиков, которые хотят, чтобы AI-ассистенты (Claude Code, Cursor, Codex) писали качественный код PostgreSQL. Вместо устаревших и неоптимальных схем нейросеть использует два источника знаний: семантический поиск по официальной документации (с учётом версии) и набор «скиллов» — проверенных паттернов проектирования. Разработчик — Timescale, компания, известная решениями для работы с временными рядами. Проект активен: 1752 звезды на GitHub и поддержка 40+ AI-агентов.
Postgres
Открыть на GitHub

Установка

npx -y @tigerdata/pg-aiguide

Характеристики

Общее

  • СтатусСообщество
  • Разработчикtimescale
  • ЛицензияApache-2.0

Технологии

  • Языки
    Python
  • Транспорт
    streamable-httpstdio

Описание

Возможности

  • Добавляет в контекст ассистента документацию PostgreSQL, TimescaleDB и PostGIS.
  • Автоматически применяет лучшие практики при генерации кода.
  • Увеличивает количество ограничений в схеме базы данных в 4 раза.
  • Увеличивает количество индексов на 55%, включая частичные и индексы по выражениям.
  • Учитывает версию PostgreSQL: документация и паттерны соответствуют актуальной версии БД.
  • Поддерживает современные конструкции: GENERATED ALWAYS AS IDENTITY, NULLS NOT DISTINCT.
  • Работает с 40+ AI-агентами: Claude Code, Cursor, Codex, Gemini CLI и другими.
  • Устанавливается одной командой npx.
  • Доступен как MCP-сервер для внешнего поиска или как скиллы для прямого контекста.

Как подключить

1. Установите скиллы PostgreSQL для вашего AI-агента:

npx skills add timescale/pg-aiguide --skill postgres

Для интерактивного выбора скиллов:

npx skills add timescale/pg-aiguide

2. Для подключения MCP-сервера добавьте в конфигурацию клиента (например, Claude Desktop):

{ "mcpServers": { "pg-aiguide": { "url": "https://mcp.tigerdata.com/docs" } }}

3. Перезапустите клиент. Теперь ассистент знает, как писать правильный код PostgreSQL.

Примеры запросов

  • «Спроектируй схему интернет-магазина на PostgreSQL 17. Добавь все необходимые ограничения, используй GENERATED ALWAYS AS IDENTITY и NULLS NOT DISTINCT.»
  • «Найди в документации правильный синтаксис частичного индекса и покажи пример для таблицы заказов.»
  • «Создай схему для логов с секционированием по месяцам. Какие индексы порекомендуешь?»
  • «Сравни две схемы для блога: с pg-aiguide и без. Покажи различия по числу индексов и ограничений.»

Технические детали

  • Язык: Python
  • Транспорт: Streamable HTTP, stdio
  • Лицензия: Apache 2.0
  • Совместимость: Claude Desktop, Claude Code, Cursor, Codex, Gemini CLI, VS Code и 40+ других MCP-агентов

Поделиться