pg-aiguide MCP — Casos de uso, Instalar & Demo ao vivo

Name: pg-aiguide MCP Server
Author: timescale

Por que usar

Principais recursos

Busca unificada na documentação PostgreSQL, TimescaleDB, PostGIS
Consciente de versão — resultados fixados na versão PG que você pergunta
Skills curados sobre design de schema, indexação, recursos PG modernos
Endpoint MCP hospedado em https://mcp.tigerdata.com/docs
Também instalável como um plugin Claude

Demo ao vivo

Como fica na prática

pg-aiguide.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "pg-aiguide",
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "pg-aiguide": {
      "command": {
        "path": "uvx",
        "args": [
          "pg-aiguide"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add pg-aiguide -- uvx pg-aiguide

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: pg-aiguide

Como fazer um agente escrever um schema Postgres em nível de produção

👤 Engenheiros backend iniciando um novo serviço ⏱ ~20 min intermediate

Quando usar: Você quer SQL gerado que realmente sobreviva a uma revisão de código.

Pré-requisitos

Adicionar o MCP pg-aiguide — Aponte o cliente para https://mcp.tigerdata.com/docs ou instale o plugin Claude

Fluxo

Declare o domínio

Preciso de um schema para um SaaS multi-tenant com orgs, users, projects, invites. Antes de escrever SQL, consulte pg-aiguide para design de schema e melhores práticas de identificadores.✓ Copiado

→ Agente cita saída de view_skill
Revisar constraints + indexes

Mostre-me cada constraint que você adicionou e por quê. Há indexes redundantes?✓ Copiado

→ Justificativa por index
Verificar recursos modernos

Use search_docs para verificar que você está usando GENERATED ALWAYS AS IDENTITY (não SERIAL), e NULLS NOT DISTINCT onde apropriado.✓ Copiado

→ Idiomas modernos aplicados

Resultado: Schema com constraints sensatos, colunas de identidade corretas, e indexes que você pode defender.

Armadilhas

Agente usa excessivamente indexes — tabelas com muita escrita ficam lentas — Peça por indexação ciente de carga de trabalho — diga a taxa esperada de leituras/escritas

Combine com: postgres

Como obter contexto especializado ao ler um plano EXPLAIN

👤 Devs otimizando uma consulta lenta ⏱ ~15 min intermediate

Quando usar: Você tem saída EXPLAIN ANALYZE e não sabe o que é normal.

Fluxo

Compartilhar o plano

[cole EXPLAIN ANALYZE] — use pg-aiguide para identificar o que cada nó faz e razões típicas para custo aqui.✓ Copiado

→ Diagnóstico nó-por-nó citando documentação
Peça conselho sobre index

Com base no plano, proponha uma mudança de index. Verifique o tipo de index (BTREE vs BRIN vs partial) via pg-aiguide.✓ Copiado

→ CREATE INDEX concreto com justificativa

Resultado: Plano compreendido, mudança defendida com documentação.

Combine com: postgres

Como escolher as configurações corretas da hypertable TimescaleDB

👤 Equipes fazendo time-series em Postgres ⏱ ~15 min advanced

Quando usar: Primeira hypertable em um novo serviço — muitos parâmetros.

Fluxo

Declare a forma de ingestão

Vou ingerir ~10k rows/sec de dados de sensor IoT, as consultas são agregados last-24h e last-30d. Consulte pg-aiguide para recomendações de intervalo de chunk da hypertable TimescaleDB.✓ Copiado

→ Intervalo de chunk + fundamentos da política de compressão
Rascunho da tabela

Rascunhe CREATE TABLE + create_hypertable + compression policy.✓ Copiado

→ DDL completo

Resultado: Configuração de hypertable ajustada para sua taxa de ingestão.

Combine com: postgres

Combinações

Combine com outros MCPs para 10× de alavancagem

pg-aiguide + postgres

Consulte pg-aiguide para melhores práticas, depois realmente as aplique via postgres MCP

Use pg-aiguide para escolher o index correto para orders.user_id, depois aplique-o via postgres MCP no banco de dados dev. Mostre EXPLAIN ANALYZE antes/depois.✓ Copiado

pg-aiguide + github

Revisão de código de uma migração de schema com raciocínio apoiado em documentação

Revise PR #4421 que adiciona uma nova tabela. Use pg-aiguide para sinalizar qualquer escolha que se desvie de PG 16 idiomático.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_docs	query: str, product?: 'postgres'\|'timescale'\|'postgis', version?: str	Procure um recurso específico, função ou configuração	free
view_skill	skill: 'schema-design'\|'indexing'\|'data-types'\|'performance'	Aplique orientação de melhores práticas antes de escrever schema	free

Custo e limites

O que custa rodar

Cota de API: Endpoint hospedado — limites de taxa de uso razoável
Tokens por chamada: 300-1500 tokens por resultado de busca
Monetário: Grátis
Dica: Use view_skill para orientação ampla, search_docs apenas quando você precisa de uma citação específica.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Nenhum — apenas documentação

Armazenamento de credenciais: Nenhum

Saída de dados: Suas consultas vão para mcp.tigerdata.com

Nunca conceda: Nada a conceder; sem acesso a banco de dados

Este MCP não executa SQL — combine com postgres MCP quando você precisar executar consultas.

Solução de problemas

Erros comuns e correções

search_docs retorna informações desatualizadas

Fixe a versão: search_docs(query, version='17') para especificidades de PG 17.

Conexão com mcp.tigerdata.com falha

Verifique o firewall corporativo; retorne ao plugin Claude (local) instalado.

Verificar: curl -I https://mcp.tigerdata.com/docs

view_skill retorna saída genérica

Especifique o slug skill exatamente — slugs desconhecidos retornam a resumos genéricos.

Alternativas

pg-aiguide vs. outros

Alternativa	Quando usar	Troca
postgres MCP	Você precisa executar SQL, não apenas ler documentação	Sem camada de melhores práticas curada
Supabase MCP	Gerenciamento de projeto específico do Supabase	Bloqueado pelo Supabase

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills