pg-aiguide MCP Server

pg-aiguide

Expertise PostgreSQL optimisée par IA pour les assistants de codage

pg-aiguide aide les outils de codage IA à écrire du code PostgreSQL nettement meilleur. Il fournit :

• Recherche sémantique dans le manuel officiel PostgreSQL (tenant compte de la version)
• « Compétences » optimisées pour l’IA — bonnes pratiques Postgres organisées et avisées, utilisées automatiquement par les agents IA
• Documentation de l’écosystème d’extensions, à commencer par TimescaleDB, avec d’autres à venir

Utilisez-le comme :

• Compétences d’agent via npx skills — fonctionne avec Claude Code, Cursor, Codex, Gemini CLI et plus de 40 autres agents
• un serveur MCP public utilisable avec n’importe quel agent de codage IA, ou
• un plugin Claude Code optimisé pour une utilisation avec le support natif des compétences de Claude.

⭐ Pourquoi pg-aiguide ?

Les outils de codage IA génèrent souvent du code Postgres qui est :

• obsolète
• dépourvu de contraintes et d’index
• ignorant des fonctionnalités modernes de PG
• incohérent avec les bonnes pratiques réelles

pg-aiguide corrige cela en donnant aux agents IA une connaissance approfondie et versionnée de PostgreSQL ainsi que des modèles éprouvés.

Voyez la différence

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

🚀 Démarrage rapide

Compétences d’agent

Installez des compétences organisées de bonnes pratiques PostgreSQL pour votre agent de codage IA :

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

Ou choisissez des compétences individuelles de manière interactive :

npx skills add timescale/pg-aiguide

Fonctionne avec Claude Code, Cursor, Codex, Gemini CLI, VS Code et plus de 40 autres agents.

Pour une connaissance PostgreSQL encore plus approfondie, ajoutez également le serveur MCP pour donner à votre agent une recherche sémantique dans les manuels officiels PostgreSQL, TimescaleDB et PostGIS.

Serveur MCP

Pour une recherche sémantique dans la documentation PostgreSQL, TimescaleDB et PostGIS, ajoutez le serveur MCP public :

https://mcp.tigerdata.com/docs

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

Ou il peut être utilisé comme plugin Claude Code :

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

Installer par environnement

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

💡 Votre première invite

Une fois installé, pg-aiguide peut répondre à des questions Postgres ou concevoir des schémas.

Exemple d’invite de schéma simple

Créez un schéma de table Postgres pour stocker des noms d’utilisateur et des adresses e-mail uniques.

Exemple d’invite de schéma complexe

Vous êtes un ingénieur logiciel senior. Vous devez générer un schéma Postgres pour une entreprise d’appareils IoT. Les appareils collectent des données environnementales sur un site industriel. Les données incluent la température, l’humidité, la pression comme points de données principaux ainsi que d’autres mesures qui varient d’un appareil à l’autre. Chaque appareil a un identifiant unique et un nom lisible par l’homme. Nous voulons également enregistrer l’heure à laquelle les données ont été collectées. L’analyse des données récentes inclut la recherche de valeurs aberrantes et d’anomalies basées sur les mesures, ainsi que l’analyse des données d’appareils particuliers pour une analyse ad hoc. L’analyse des données historiques inclut l’analyse de l’historique des données d’un appareil ou l’obtention de statistiques pour tous les appareils sur de longues périodes.

Fonctionnalités

Recherche documentaire (outils MCP)

• search_docs Outil de recherche unifié prenant en charge la recherche sémantique (similarité vectorielle) et par mots-clés (BM25) à travers plusieurs sources de documentation :
  • postgres - Manuel officiel PostgreSQL, délimité par version
  • tiger - Documentation de Tiger Data (TimescaleDB et écosystème)
  • postgis - Documentation de l’extension spatiale PostGIS

Compétences (bonnes pratiques optimisées pour l’IA)

• view_skill
  Expose des compétences organisées et avisées de bonnes pratiques PostgreSQL utilisées automatiquement par les assistants de codage IA.

  Ces compétences fournissent des conseils sur :

  • La conception de schémas
  • Les stratégies d’indexation
  • Les types de données
  • L’intégrité des données et les contraintes
  • Les conventions de nommage
  • L’optimisation des performances
  • Les fonctionnalités modernes de PostgreSQL

🔌 Documentation de l’écosystème

Pris en charge aujourd’hui :

• TimescaleDB (docs + compétences)
• PostGIS (docs)

À venir prochainement :

• pgvector

Nous accueillons les contributions pour des extensions et outils supplémentaires.

🛠 Développement

Voir DEVELOPMENT.md pour :

• exécuter le serveur MCP localement
• ajouter de nouvelles compétences
• ajouter de nouvelles documentations

🤝 Contribution

Nous accueillons :

• de nouvelles compétences de bonnes pratiques Postgres
• des corpus de documentation supplémentaires
• des améliorations de la qualité de recherche
• des rapports de bogues et des idées de fonctionnalités

📄 Licence

Apache 2.0