# pg-aiguide

Даёт ИИ-агенту семантический поиск по мануалам PostgreSQL, TimescaleDB и PostGIS и подборки лучших практик, чтобы код был версионно корректным.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1874
- Автор: timescale
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/timescale/pg-aiguide
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/pg-aiguide

## Что делает

pg-aiguide — публичный MCP-сервер от Timescale. Агент получает доступ к семантическому поиску по официальному мануалу PostgreSQL с учётом версии, по документации TimescaleDB и PostGIS, плюс к набору готовых «скиллов» с проверенными практиками. Всё это подключается к Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline и Zed.

Есть два способа работы. Первый — удалённый HTTP-эндпоинт `https://mcp.tigerdata.com/docs`, ему не нужны ни ключи, ни локальный запуск. Второй — локальный запуск через `npx -y @tigerdata/pg-aiguide` в режиме stdio: тогда понадобятся `OPENAI_API_KEY` и переменные подключения к базе — `PGHOST`, `PGPORT`, `PGUSER`, `PGPASSWORD`. Без них локальный вариант не стартует, так что для быстрой пробы берите удалённый.

Отдельно репозиторий работает как плагин Claude: он подключает те же скиллы и публичный MCP-эндпоинт. Скиллы можно поставить и без сервера — через `npx skills add timescale/pg-aiguide --skill postgres` или `--skill schema-exploration` для разбора существующей базы.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.tigerdata.com/docs`
- Переменные окружения: `OPENAI_API_KEY`, `PGHOST`, `PGPORT`, `PGUSER`, `PGPASSWORD`, `PGDATABASE`, `DB_SCHEMA` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http pg-aiguide https://mcp.tigerdata.com/docs
```

2. **Командой платформы**
```bash
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env PGHOST=<PGHOST> --env PGPORT=<PGPORT> --env PGUSER=<PGUSER> --env PGPASSWORD=<PGPASSWORD> --transport stdio pg-aiguide -- npx -y @tigerdata/pg-aiguide
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add pg-aiguide --url https://mcp.tigerdata.com/docs
```

2. **Командой платформы**
```bash
codex mcp add pg-aiguide --env OPENAI_API_KEY=<OPENAI_API_KEY> --env PGHOST=<PGHOST> --env PGPORT=<PGPORT> --env PGUSER=<PGUSER> --env PGPASSWORD=<PGPASSWORD> -- npx -y @tigerdata/pg-aiguide
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pg-aiguide": {
            "url": "https://mcp.tigerdata.com/docs"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pg-aiguide": {
            "command": "npx",
            "args": [
                "-y",
                "@tigerdata/pg-aiguide"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "PGHOST": "<PGHOST>",
                "PGPORT": "<PGPORT>",
                "PGUSER": "<PGUSER>",
                "PGPASSWORD": "<PGPASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pg-aiguide": {
            "type": "http",
            "url": "https://mcp.tigerdata.com/docs"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pg-aiguide": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tigerdata/pg-aiguide"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "PGHOST": "<PGHOST>",
                "PGPORT": "<PGPORT>",
                "PGUSER": "<PGUSER>",
                "PGPASSWORD": "<PGPASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http pg-aiguide https://mcp.tigerdata.com/docs
```

2. **Командой платформы**
```bash
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e PGHOST=<PGHOST> -e PGPORT=<PGPORT> -e PGUSER=<PGUSER> -e PGPASSWORD=<PGPASSWORD> pg-aiguide npx -y @tigerdata/pg-aiguide
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- писать схему БД без устаревших конструкций PostgreSQL
- найти нужный раздел мануала под конкретную версию PG
- добавить ограничения и индексы, которые агент обычно пропускает
- разобрать структуру уже существующей базы
- свериться с документацией TimescaleDB или PostGIS

## Примеры запросов агенту
- Опиши схему для интернет-магазина на стандартном PostgreSQL и сохрани в `schema.sql`
- Найди в мануале PostgreSQL 17, как правильно объявить `GENERATED ALWAYS AS IDENTITY`
- Изучи существующую базу и покажи, каких индексов не хватает

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md