Pg Aiguide

Pg Aiguide

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

Подключить Pg Aiguide

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "pg-aiguide": {
      "command": "npx",
      "args": [
        "-y",
        "@tigerdata/pg-aiguide"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Pg Aiguide

Pg Aiguide относится к PostgreSQL. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
Apache-2.0
Реализация
Python
Транспорт
streamable-http, stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

  • СтатусСообщество
  • Разработчик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-агентов

Поделиться