pg-aiguide MCP Server

pg-aiguide

Experiencia PostgreSQL optimizada con IA para asistentes de codificación

pg-aiguide ayuda a las herramientas de codificación con IA a escribir código PostgreSQL mucho mejor. Proporciona:

• Búsqueda semántica en el manual oficial de PostgreSQL (con reconocimiento de versiones)
• “Habilidades” optimizadas para IA — mejores prácticas de Postgres seleccionadas y con opiniones definidas, utilizadas automáticamente por agentes de IA
• Documentación del ecosistema de extensiones, comenzando con TimescaleDB, y más próximamente

Úsalo como:

• Habilidades de Agente a través de npx skills — funciona con Claude Code, Cursor, Codex, Gemini CLI y más de 40 agentes
• un servidor MCP público que puede usarse con cualquier agente de codificación de IA, o
• un plugin de Claude Code optimizado para usar con el soporte nativo de habilidades de Claude.

⭐ ¿Por qué pg-aiguide?

Las herramientas de codificación con IA a menudo generan código Postgres que es:

• anticuado
• carente de restricciones e índices
• desconocedor de las características modernas de PG
• inconsistente con las mejores prácticas del mundo real

pg-aiguide soluciona esto proporcionando a los agentes de IA conocimiento profundo y versionado de PostgreSQL y patrones probados.

Ve la diferencia

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

🚀 Inicio rápido

Habilidades de Agente

Instala habilidades seleccionadas de mejores prácticas de PostgreSQL para tu agente de codificación de IA:

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

O elige habilidades individuales de forma interactiva:

npx skills add timescale/pg-aiguide

Funciona con Claude Code, Cursor, Codex, Gemini CLI, VS Code y más de 40 agentes.

Para un conocimiento aún más profundo de PostgreSQL, añade también el servidor MCP para dar a tu agente búsqueda semántica sobre los manuales oficiales de PostgreSQL, TimescaleDB y PostGIS.

Servidor MCP

Para búsqueda semántica sobre la documentación de PostgreSQL, TimescaleDB y PostGIS, añade el servidor MCP público:

https://mcp.tigerdata.com/docs

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

O puede usarse como un Plugin de Claude Code:

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

Instalar por entorno

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

💡 Tu primera consulta

Una vez instalado, pg-aiguide puede responder preguntas sobre Postgres o diseñar esquemas.

Ejemplo de consulta para un esquema simple

Crea un esquema de tabla Postgres para almacenar nombres de usuario y direcciones de correo electrónico únicas.

Ejemplo de consulta para un esquema complejo

Eres un ingeniero de software sénior. Se te asigna la tarea de generar un esquema Postgres para una empresa de dispositivos IoT. Los dispositivos recopilan datos ambientales en una planta de fábrica. Los datos incluyen temperatura, humedad, presión, como los puntos de datos principales, así como otras mediciones que varían de un dispositivo a otro. Cada dispositivo tiene una identificación única y un nombre legible por humanos. Queremos registrar también la hora en que se recopilaron los datos. El análisis de datos recientes incluye encontrar valores atípicos y anomalías basadas en las mediciones, así como analizar los datos de dispositivos particulares para análisis ad-hoc. El análisis de datos históricos incluye analizar el historial de datos de un dispositivo u obtener estadísticas de todos los dispositivos durante largos períodos de tiempo.

Características

Búsqueda en Documentación (Herramientas MCP)

• search_docs Herramienta de búsqueda unificada que admite búsqueda semántica (similitud vectorial) y por palabras clave (BM25) en múltiples fuentes de documentación:
  • postgres - Manual oficial de PostgreSQL, acotado por versión
  • tiger - Documentación de Tiger Data (TimescaleDB y ecosistema)
  • postgis - Documentación de la extensión espacial PostGIS

Habilidades (Mejores Prácticas Optimizadas para IA)

• view_skill
  Expone habilidades seleccionadas y con opiniones definidas de mejores prácticas de PostgreSQL utilizadas automáticamente por asistentes de codificación de IA.

  Estas habilidades proporcionan orientación sobre:

  • Diseño de esquemas
  • Estrategias de indexación
  • Tipos de datos
  • Integridad de datos y restricciones
  • Convenciones de nomenclatura
  • Ajuste de rendimiento
  • Características modernas de PostgreSQL

🔌 Documentación del Ecosistema

Soportado hoy:

• TimescaleDB (documentos + habilidades)
• PostGIS (documentos)

Próximamente:

• pgvector

Agradecemos contribuciones para extensiones y herramientas adicionales.

🛠 Desarrollo

Consulta DEVELOPMENT.md para:

• ejecutar el servidor MCP localmente
• añadir nuevas habilidades
• añadir nuevos documentos

🤝 Contribuciones

Agradecemos:

• nuevas habilidades de mejores prácticas de Postgres
• corpus de documentación adicional
• mejoras en la calidad de búsqueda
• informes de errores e ideas de funcionalidades

📄 Licencia

Apache 2.0