
pg-aiguide
timescalev0.6.1Apache-2.0
1.9k звёзд120 форков
pg-aiguide — это MCP-сервер для разработчиков, которые хотят, чтобы AI-ассистенты (Claude Code, Cursor, Codex) писали качественный код PostgreSQL. Вместо устаревших и неоптимальных схем нейросеть использует два источника знаний: семантический поиск по официальной документации (с учётом версии) и набор «скиллов» — проверенных паттернов проектирования.
Разработчик — Timescale, компания, известная решениями для работы с временными рядами. Проект активен: 1752 звезды на GitHub и поддержка 40+ AI-агентов.
- Сервер сообщества
- Локальный и удалённый запуск
- Python
- Лицензия Apache-2.0
- Обновлён 21 ноября 2026 г.
Подключение
Подключить pg-aiguide
Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.
1
Способ подключения
2
Куда подключить
3
Скопируйте и проверьте
Claude Desktop / Claude Code
Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.
- 1.Откройте настройки MCP в Claude.
- 2.Добавьте сервер с указанной командой и переменными окружения.
- 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
"mcpServers": {
"pg-aiguide": {
"command": "npx",
"args": [
"-y",
"@tigerdata/pg-aiguide"
]
}
}
}Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.
Характеристики
Общее
- СтатусСообщество
- Разработчикtimescale
- Версияv0.6.1
- ЛицензияApache-2.0
- Последний релиз04.09.2026
- Активность источника21.11.2026
Технологии
- ЯзыкиPython
- ТранспортStreamable HTTP — удалённыйstdio — локальный запуск
Описание
Возможности
- Добавляет в контекст ассистента документацию 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-агентов




