pg-aiguide

pg-aiguide

Experiência PostgreSQL otimizada por IA para assistentes de codificação

O pg-aiguide ajuda ferramentas de codificação de IA a escrever código PostgreSQL significativamente melhor. Ele fornece:

• Busca semântica no manual oficial do PostgreSQL (ciente da versão)
• “Habilidades” otimizadas por IA — práticas recomendadas de Postgres selecionadas e opinativas usadas automaticamente por agentes de IA
• Documentação do ecossistema de extensões, começando com TimescaleDB, com mais em breve

Use-o como:

• Habilidades de Agente via npx skills — funciona com Claude Code, Cursor, Codex, Gemini CLI e mais de 40 outros agentes
• um servidor MCP público que pode ser usado com qualquer agente de codificação de IA, ou
• um plugin Claude Code otimizado para uso com o suporte nativo de habilidades do Claude.

⭐ Por que pg-aiguide?

Ferramentas de codificação de IA frequentemente geram código Postgres que é:

• desatualizado
• sem restrições e índices
• desconhece recursos modernos do PG
• inconsistente com as melhores práticas do mundo real

O pg-aiguide corrige isso dando aos agentes de IA conhecimento profundo e versionado do PostgreSQL e padrões comprovados.

Veja a diferença

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

🚀 Início Rápido

Habilidades de Agente

Instale habilidades de melhores práticas PostgreSQL selecionadas para seu agente de codificação de IA:

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

Ou instale a habilidade de exploração de esquema para investigar um banco de dados PostgreSQL existente:

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

Ou escolha habilidades individuais interativamente:

npx skills add timescale/pg-aiguide

Funciona com Claude Code, Cursor, Codex, Gemini CLI, VS Code e mais de 40 outros agentes.

Para conhecimento ainda mais profundo do PostgreSQL, adicione também o servidor MCP para dar ao seu agente busca semântica nos manuais oficiais do PostgreSQL, TimescaleDB e PostGIS.

Servidor MCP

Para busca semântica na documentação do PostgreSQL, TimescaleDB e PostGIS, adicione o servidor MCP público:

https://mcp.tigerdata.com/docs

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

Ou pode ser usado como um Plugin Claude Code:

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

Instalar por ambiente

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"
    }
  }
}

💡 Seu Primeiro Prompt

Uma vez instalado, o pg-aiguide pode responder perguntas sobre Postgres ou projetar esquemas.

Exemplo de prompt de esquema simples

Crie um esquema de tabela Postgres para armazenar nomes de usuário e endereços de e-mail únicos.

Exemplo de prompt de esquema complexo

Você é um engenheiro de software sênior. Você recebeu a tarefa de gerar um esquema Postgres para uma empresa de dispositivos IoT. Os dispositivos coletam dados ambientais no chão de uma fábrica. Os dados incluem temperatura, umidade, pressão, como os principais pontos de dados, bem como outras medições que variam de dispositivo para dispositivo. Cada dispositivo tem um id único e um nome legível por humanos. Queremos registrar o horário em que os dados foram coletados também. A análise de dados recentes inclui encontrar outliers e anomalias com base nas medições, bem como analisar os dados de dispositivos específicos para análise ad-hoc. A análise de dados históricos inclui analisar o histórico de dados de um dispositivo ou obter estatísticas para todos os dispositivos ao longo de longos períodos de tempo.

Recursos

Busca de Documentação (Ferramentas MCP)

• search_docs Ferramenta de busca unificada que suporta busca semântica (similaridade vetorial) e por palavras-chave (BM25) em múltiplas fontes de documentação:
  • postgres - Manual oficial do PostgreSQL, limitado por versão
  • tiger - Documentação da Tiger Data (TimescaleDB e ecossistema)
  • postgis - Documentação da extensão espacial PostGIS

Habilidades (Melhores Práticas Otimizadas por IA)

• view_skill
  Expõe habilidades de melhores práticas PostgreSQL selecionadas e opinativas usadas automaticamente por assistentes de codificação de IA.

  Essas habilidades fornecem orientação sobre:

  • Explorar esquemas e objetos PostgreSQL existentes
  • Design de esquemas
  • Estratégias de indexação
  • Tipos de dados
  • Integridade de dados e restrições
  • Convenções de nomenclatura
  • Ajuste de desempenho
  • Recursos modernos do PostgreSQL

🔌 Documentação do Ecossistema

Suportado hoje:

• TimescaleDB (documentação + habilidades)
• PostGIS (documentação)

Em breve:

• pgvector

Aceitamos contribuições para extensões e ferramentas adicionais.

🛠 Desenvolvimento

Consulte DEVELOPMENT.md para:

• executar o servidor MCP localmente
• adicionar novas habilidades
• adicionar nova documentação

🤝 Contribuindo

Aceitamos:

• novas habilidades de melhores práticas Postgres
• corpora de documentação adicionais
• melhorias na qualidade da busca
• relatórios de bugs e ideias de recursos

📄 Licença

Apache 2.0