pg-aiguide MCP Server

pg-aiguide

Expertise PostgreSQL otimizada por IA para assistentes de codificação

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

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

Use-o como:

• Agent Skills 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 do Claude Code otimizado para uso com o suporte nativo de skills do Claude.

⭐ Por que pg-aiguide?

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

• desatualizado
• sem constraints e índices
• desconhecedor de recursos modernos do PG
• inconsistente com as melhores práticas do mundo real

O pg-aiguide resolve isso fornecendo aos agentes de IA conhecimento profundo e versionado de PostgreSQL e padrões comprovados.

Veja a diferença

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

🚀 Início Rápido

Agent Skills

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

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

Ou escolha skills 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 um conhecimento ainda mais profundo de 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 do 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

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 schemas.

Exemplo de prompt para schema simples

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

Exemplo de prompt para schema complexo

Você é um engenheiro de software sênior. Você recebeu a tarefa de gerar um schema Postgres para uma empresa de dispositivos IoT. Os dispositivos coletam dados ambientais em um chão de 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 também o horário em que os dados foram coletados. 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 por longos períodos de tempo.

Recursos

Busca em Documentação (Ferramentas MCP)

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

Skills (Melhores Práticas Otimizadas para IA)

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

  Essas skills fornecem orientação sobre:

  • Design de schema
  • Estratégias de indexação
  • Tipos de dados
  • Integridade de dados e constraints
  • Convenções de nomenclatura
  • Ajuste de performance
  • Recursos modernos do PostgreSQL

🔌 Documentação do Ecossistema

Suportado hoje:

• TimescaleDB (docs + skills)
• PostGIS (docs)

Em breve:

• pgvector

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

🛠 Desenvolvimento

Veja DEVELOPMENT.md para:

• executar o servidor MCP localmente
• adicionar novas skills
• adicionar novas documentações

🤝 Contribuindo

Aceitamos:

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

📄 Licença

Apache 2.0