pg-aiguide

pg-aiguide

Оптимизированная для ИИ экспертиза по PostgreSQL для ассистентов программирования

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

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

Используйте его как:

• Навыки агента через npx skills — работает с Claude Code, Cursor, Codex, Gemini CLI и более чем 40 другими агентами
• публичный MCP-сервер, который можно использовать с любым ИИ-агентом для написания кода, или
• плагин Claude Code, оптимизированный для использования с нативной поддержкой навыков Claude.

⭐ Зачем pg-aiguide?

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

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

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

Посмотрите разницу

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

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

Навыки агента

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

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

Или установите навык исследования схемы для изучения существующей базы данных PostgreSQL:

npx skills add timescale/pg-aiguide --skill schema-exploration

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

npx skills add timescale/pg-aiguide

Работает с 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:

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

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

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

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

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

gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

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

💡 Ваш первый запрос

После установки pg-aiguide может отвечать на вопросы о Postgres или проектировать схемы.

Пример простого запроса на создание схемы

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

Пример сложного запроса на создание схемы

Вы — старший инженер-программист. Вам поставлена задача создать схему Postgres для компании, производящей IoT-устройства. Устройства собирают данные об окружающей среде на заводском полу. Данные включают температуру, влажность, давление как основные точки данных, а также другие измерения, которые варьируются от устройства к устройству. Каждое устройство имеет уникальный идентификатор и читаемое человеком имя. Мы также хотим записывать время сбора данных. Анализ недавних данных включает поиск выбросов и аномалий на основе измерений, а также анализ данных конкретных устройств для ad-hoc анализа. Анализ исторических данных включает анализ истории данных для одного устройства или получение статистики для всех устройств за длительные периоды времени.

Возможности

Поиск по документации (инструменты MCP)

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

Навыки (оптимизированные для ИИ лучшие практики)

• view_skill
  Предоставляет курируемые, основанные на мнениях навыки лучших практик PostgreSQL, которые автоматически используются ИИ-ассистентами по написанию кода.

  Эти навыки дают рекомендации по:

  • Изучению существующих схем и объектов PostgreSQL
  • Проектированию схем
  • Стратегиям индексирования
  • Типам данных
  • Целостности данных и ограничениям
  • Соглашениям об именовании
  • Настройке производительности
  • Современным функциям PostgreSQL

🔌 Документация экосистемы

Поддерживается сегодня:

• TimescaleDB (документация + навыки)
• PostGIS (документация)

Скоро:

• pgvector

Мы приветствуем вклад в виде дополнительных расширений и инструментов.

🛠 Разработка

См. DEVELOPMENT.md для:

• запуска MCP-сервера локально
• добавления новых навыков
• добавления новой документации

🤝 Вклад

Мы приветствуем:

• новые навыки лучших практик Postgres
• дополнительные корпуса документации
• улучшения качества поиска
• отчёты об ошибках и идеи функций

📄 Лицензия

Apache 2.0