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

Name: pg-aiguide MCP Server
Author: timescale

Por qué usarlo

Características clave

Búsqueda unificada en documentación de PostgreSQL, TimescaleDB, PostGIS
Compatible con versiones — resultados anclados a la versión de PG que especifiques
Habilidades curadas sobre diseño de esquemas, indexación, características modernas de PG
Endpoint MCP alojado en https://mcp.tigerdata.com/docs
También instalable como plugin de Claude

Demo en vivo

Cómo se ve en la práctica

pg-aiguide.replay ▶ listo

0/0

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: pg-aiguide

Cómo hacer que un agente escriba un esquema Postgres de grado productivo

👤 Ingenieros de backend comenzando un nuevo servicio ⏱ ~20 min intermediate

Cuándo usarlo: Quieres SQL generado que realmente sobreviva una revisión de código.

Requisitos previos

Añade el MCP pg-aiguide — Apunta el cliente a https://mcp.tigerdata.com/docs o instala el plugin de Claude

Flujo

Especifica el dominio

Necesito un esquema para un SaaS multi-inquilino con orgs, usuarios, proyectos, invitaciones. Antes de escribir SQL, consulta pg-aiguide para diseño de esquemas y mejores prácticas de identificadores.✓ Copiado

→ El agente cita la salida de view_skill
Revisa restricciones + índices

Muéstrame cada restricción que añadiste y por qué. ¿Algún índice redundante?✓ Copiado

→ Justificación por índice
Verifica características modernas

Usa search_docs para verificar que estás usando GENERATED ALWAYS AS IDENTITY (no SERIAL), y NULLS NOT DISTINCT donde sea apropiado.✓ Copiado

→ Idiomas modernos aplicados

Resultado: Esquema con restricciones sensatas, columnas de identidad correctas, e índices que puedas defender.

Errores comunes

El agente sobrecarga índices — las tablas pesadas en escritura se ralentizan — Solicita indexación consciente de la carga de trabajo — dile la relación esperada de lecturas/escrituras

Combinar con: postgres

Cómo obtener contexto experto al leer un plan EXPLAIN

👤 Desarrolladores optimizando una consulta lenta ⏱ ~15 min intermediate

Cuándo usarlo: Tienes salida EXPLAIN ANALYZE y no sabes qué es normal.

Flujo

Comparte el plan

[pega EXPLAIN ANALYZE] — usa pg-aiguide para identificar qué hace cada nodo y razones típicas del costo aquí.✓ Copiado

→ Diagnóstico nodo a nodo citando documentación
Solicita consejo sobre índices

Basándote en el plan, propón un cambio de índice. Verifica el tipo de índice (BTREE vs BRIN vs parcial) a través de pg-aiguide.✓ Copiado

→ CREATE INDEX concreto con justificación

Resultado: Plan entendido, cambio defendido con documentación.

Combinar con: postgres

Cómo elegir la configuración correcta de hipertabla en TimescaleDB

👤 Equipos haciendo series de tiempo en Postgres ⏱ ~15 min advanced

Cuándo usarlo: Primera hipertabla en un nuevo servicio — muchos parámetros.

Flujo

Especifica la forma de ingesta

Ingestaré ~10k filas/seg de datos de sensores IoT, las consultas son agregados de las últimas 24h y últimos 30d. Consulta pg-aiguide para recomendaciones de intervalo de fragmentos de hipertabla en TimescaleDB.✓ Copiado

→ Intervalo de fragmentos + justificación de política de compresión
Redacta la tabla

Redacta CREATE TABLE + create_hypertable + política de compresión.✓ Copiado

→ DDL completo

Resultado: Configuración de hipertabla ajustada a tu tasa de ingesta.

Combinar con: postgres

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

pg-aiguide + postgres

Consulta pg-aiguide para mejores prácticas, luego aplícalas a través del MCP postgres

Usa pg-aiguide para elegir el índice correcto para orders.user_id, luego aplícalo a través del MCP postgres en la BD de desarrollo. Muestra EXPLAIN ANALYZE antes/después.✓ Copiado

pg-aiguide + github

Revisa código de una migración de esquema con razonamiento respaldado por documentación

Revisa PR #4421 que añade una nueva tabla. Usa pg-aiguide para señalar cualquier elección que se desvíe de idiomatic PG 16.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
search_docs	query: str, product?: 'postgres'\|'timescale'\|'postgis', version?: str	Busca una característica, función o configuración específica	free
view_skill	skill: 'schema-design'\|'indexing'\|'data-types'\|'performance'	Aplica orientación de mejores prácticas antes de escribir el esquema	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Endpoint alojado — límites de velocidad de uso razonable
Tokens por llamada: 300-1500 tokens por resultado de búsqueda
Monetario: Gratis
Consejo: Usa view_skill para orientación general, search_docs solo cuando necesites una cita específica.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Ninguno — solo documentación

Almacenamiento de credenciales: Ninguno

Salida de datos: Tus consultas van a mcp.tigerdata.com

No conceder nunca: Nada para otorgar; sin acceso a BD

Este MCP no ejecuta SQL — combínalo con MCP postgres cuando necesites ejecutar consultas.

Resolución de problemas

Errores comunes y soluciones

search_docs devuelve información desactualizada

Fija la versión: search_docs(query, version='17') para especificidades de PG 17.

La conexión a mcp.tigerdata.com falla

Verifica el firewall corporativo; vuelve al plugin de Claude (instalación local).

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

view_skill devuelve salida genérica

Especifica el slug de habilidad exactamente — slugs desconocidos vuelven a resúmenes genéricos.

Alternativas

pg-aiguide vs otros

Alternativa	Cuándo usarla	Contrapartida
postgres MCP	Necesitas ejecutar SQL, no solo leer documentación	Sin capa de mejores prácticas curada
Supabase MCP	Gestión de proyectos específica de Supabase	Bloqueado en Supabase

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills