pg-aiguide MCP Server

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

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

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

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

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

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

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

Скоро:

• pgvector

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

🛠 Разработка

См. DEVELOPMENT.md для:

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

🤝 Участие в проекте

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

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

📄 Лицензия

Apache 2.0