pg-aiguide

AI-оптимизированная экспертиза по PostgreSQL для coding-ассистентов

pg-aiguide помогает AI-инструментам для написания кода генерировать значительно более качественный PostgreSQL-код. Он предоставляет:

• Семантический поиск по официальному руководству PostgreSQL (с учётом версии)
• AI-оптимизированные «скиллы» — отобранные, опinionated лучшие практики Postgres, автоматически используемые AI-агентами
• Документацию по экосистеме расширений, начиная с TimescaleDB, с дальнейшим расширением списка

Можно использовать как:

• Agent Skills через npx skills — работает с Claude Code, Cursor, Codex, Gemini CLI и 40+ другими агентами
• публичный MCP-сервер, совместимый с любым AI coding-агентом
• Claude Code plugin, оптимизированный для нативной поддержки скиллов в Claude

⭐ Зачем pg-aiguide?

AI-инструменты для написания кода нередко генерируют Postgres-код, который:

• устарел
• не содержит ограничений и индексов
• не использует современные возможности PG
• не соответствует реальным best practices

pg-aiguide исправляет это, предоставляя AI-агентам глубокие, версионированные знания о PostgreSQL и проверенные паттерны.

Разница на практике

https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d

Запрос к Claude Code:

Опиши схему, которую ты создал бы для интернет-магазина, дважды: сначала с отключённым MCP-сервером tiger, затем с включённым. Каждый раз записывай схему в отдельный файл в текущей рабочей директории. Затем сравни два файла и объясни, какой подход дал лучшую схему, используя качественные и количественные аргументы. В этом примере используй только стандартный Postgres.

Результат (кратко):

• В 4 раза больше ограничений
• На 55% больше индексов (включая частичные и индексы по выражениям)
• Паттерны, рекомендованные в PG17
• Современные возможности (GENERATED ALWAYS AS IDENTITY, NULLS NOT DISTINCT)
• Более чистые именование и документация

Вывод: pg-aiguide генерирует более надёжные, производительные и поддерживаемые схемы.

🚀 Быстрый старт

Agent Skills

Установите отобранные скиллы с лучшими практиками PostgreSQL для вашего AI coding-агента:

Или выберите отдельные скиллы в интерактивном режиме:

Работает с Claude Code, Cursor, Codex, Gemini CLI, VS Code и 40+ другими агентами.

Для ещё более глубоких знаний о PostgreSQL добавьте также MCP-сервер, чтобы агент мог выполнять семантический поиск по официальным руководствам PostgreSQL, TimescaleDB и PostGIS.

MCP-сервер

Для семантического поиска по документации PostgreSQL, TimescaleDB и PostGIS добавьте публичный MCP-сервер:

https://mcp.tigerdata.com/docs

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

Также можно использовать как Claude Code Plugin:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

Установка по среде разработки

Этот репозиторий является плагином для маркетплейса Claude Code. Для установки выполните:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

Плагин использует скиллы из директории skills, а также публично доступный MCP-эндпоинт, размещённый TigerData, для поиска по документации PostgreSQL.

Выполните следующую команду, чтобы добавить MCP-сервер в Codex:

Установка в один клик:

Или добавьте следующее в .cursor/mcp.json:

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

Выполните следующую команду, чтобы добавить MCP-сервер в Gemini CLI: