pg-aiguide

pg-aiguide

Experiencia experta en PostgreSQL optimizada para IA, para asistentes de codificación

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

• Búsqueda semántica en el manual oficial de PostgreSQL (consciente de la versión)
• "Habilidades" optimizadas para IA: prácticas recomendadas de Postgres curadas y con opinión, utilizadas automáticamente por agentes de IA
• Documentación del ecosistema de extensiones, comenzando con TimescaleDB, con más próximamente

Úsalo como:

• Habilidades de agente mediante npx skills: funciona con Claude Code, Cursor, Codex, Gemini CLI y más de 40 otros agentes
• un servidor MCP público que se puede usar con cualquier agente de codificación de IA, o
• un plugin de Claude Code optimizado para usarse 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:

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

pg-aiguide soluciona eso brindando 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 de mejores prácticas de PostgreSQL curadas para tu agente de codificación con IA:

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

O instala la habilidad de exploración de esquemas para investigar una base de datos PostgreSQL existente:

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

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 otros agentes.

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

Servidor MCP

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

https://mcp.tigerdata.com/docs

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

O se puede usar como un Plugin de Claude Code:

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

Instalación 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

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

💡 Tu primera indicación

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

Ejemplo de indicación de esquema simple

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

Ejemplo de indicación de esquema complejo

Eres un ingeniero de software senior. Se te asigna la tarea de generar un esquema Postgres para una empresa de dispositivos IoT. Los dispositivos recopilan datos ambientales en un piso 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. También queremos registrar la hora en que se recopilaron los datos. El análisis de datos recientes incluye encontrar valores atípicos y anomalías basados en 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 de documentación (Herramientas MCP)

• search_docs Herramienta de búsqueda unificada que admite búsqueda semántica (similitud de vectores) y por palabras clave (BM25) en múltiples fuentes de documentación:
  • postgres - Manual oficial de PostgreSQL, limitado 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 de mejores prácticas de PostgreSQL curadas y con opinión, utilizadas automáticamente por asistentes de codificación con IA.

  Estas habilidades brindan orientación sobre:

  • Exploración de esquemas y objetos PostgreSQL existentes
  • 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

Compatible hoy:

• TimescaleDB (documentación + habilidades)
• PostGIS (documentación)

Próximamente:

• pgvector

Aceptamos contribuciones para extensiones y herramientas adicionales.

🛠 Desarrollo

Consulta DEVELOPMENT.md para:

• ejecutar el servidor MCP localmente
• agregar nuevas habilidades
• agregar nueva documentación

🤝 Contribuciones

Aceptamos:

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

📄 Licencia

Apache 2.0