pg-aiguide MCP — Cas d'usage, Installer & Démo en direct

Name: pg-aiguide MCP Server
Author: timescale

Pourquoi l'utiliser

Fonctionnalités clés

Recherche unifiée dans la documentation PostgreSQL, TimescaleDB, PostGIS
Conscient des versions — résultats épinglés à la version PG que vous demandez
Compétences curées sur la conception de schéma, l'indexation, les fonctionnalités PG modernes
Point de terminaison MCP hébergé à https://mcp.tigerdata.com/docs
Aussi installable en tant que plugin Claude

Démo en direct

Aperçu en pratique

pg-aiguide.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : pg-aiguide

Comment faire en sorte qu'un agent écrive un schéma Postgres de qualité production

👤 Ingénieurs backend démarrant un nouveau service ⏱ ~20 min intermediate

Quand l'utiliser : Vous voulez du SQL généré qui survive vraiment à une relecture de code.

Prérequis

Ajouter le MCP pg-aiguide — Pointez le client vers https://mcp.tigerdata.com/docs ou installez le plugin Claude

Déroulement

Déclarez le domaine

J'ai besoin d'un schéma pour une SaaS multi-locataires avec des organisations, des utilisateurs, des projets, des invitations. Avant d'écrire du SQL, consultez pg-aiguide pour la conception de schéma et les bonnes pratiques d'identifiants.✓ Copié

→ L'agent cite la sortie view_skill
Vérifiez les contraintes + index

Montrez-moi chaque contrainte que vous avez ajoutée et pourquoi. Des index redondants ?✓ Copié

→ Justification par index
Vérifiez les fonctionnalités modernes

Utilisez search_docs pour vérifier que vous utilisez GENERATED ALWAYS AS IDENTITY (pas SERIAL) et NULLS NOT DISTINCT où approprié.✓ Copié

→ Idiomes modernes appliqués

Résultat : Schéma avec des contraintes sensées, les bonnes colonnes d'identité et des index que vous pouvez défendre.

Pièges

L'agent utilise trop d'index — les tableaux intensifs en écriture ralentissent — Demandez une indexation consciente de la charge — dites-lui le ratio lecture/écriture attendu

Combiner avec : postgres

Comment obtenir un contexte expert lors de la lecture d'un plan EXPLAIN

👤 Développeurs optimisant une requête lente ⏱ ~15 min intermediate

Quand l'utiliser : Vous avez une sortie EXPLAIN ANALYZE et ne savez pas ce qui est normal.

Déroulement

Partagez le plan

[collez EXPLAIN ANALYZE] — utilisez pg-aiguide pour identifier ce que chaque nœud fait et les raisons typiques du coût ici.✓ Copié

→ Diagnostic nœud par nœud citant la documentation
Demandez des conseils d'index

En fonction du plan, proposez un changement d'index. Vérifiez le type d'index (BTREE vs BRIN vs partiel) via pg-aiguide.✓ Copié

→ CREATE INDEX concret avec justification

Résultat : Plan compris, changement défendu avec la documentation.

Combiner avec : postgres

Comment choisir les bons paramètres de hypertable TimescaleDB

👤 Équipes faisant des séries temporelles sur Postgres ⏱ ~15 min advanced

Quand l'utiliser : Première hypertable dans un nouveau service — plusieurs paramètres.

Déroulement

Déclarez la forme d'ingestion

J'ingérerai ~10k lignes/sec de données de capteurs IoT, les requêtes sont des agrégats des 24 dernières heures et des 30 derniers jours. Consultez pg-aiguide pour les recommandations d'intervalle de chunk de hypertable TimescaleDB.✓ Copié

→ Intervalle de chunk + justification de la politique de compression
Rédigez le tableau

Rédigez le CREATE TABLE + create_hypertable + politique de compression.✓ Copié

→ DDL complet

Résultat : Configuration de hypertable accordée à votre taux d'ingestion.

Combiner avec : postgres

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

pg-aiguide + postgres

Consultez pg-aiguide pour les bonnes pratiques, puis appliquez-les réellement via le MCP postgres

Utilisez pg-aiguide pour choisir le bon index pour orders.user_id, puis appliquez-le via le MCP postgres sur la DB de développement. Affichez EXPLAIN ANALYZE avant/après.✓ Copié

pg-aiguide + github

Vérification du code d'une migration de schéma avec un raisonnement soutenu par la documentation

Vérifiez la PR #4421 qui ajoute une nouvelle table. Utilisez pg-aiguide pour signaler tout choix qui s'écarte du PG 16 idiomatique.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search_docs	query: str, product?: 'postgres'\|'timescale'\|'postgis', version?: str	Rechercher une fonctionnalité, une fonction ou un paramètre spécifique	free
view_skill	skill: 'schema-design'\|'indexing'\|'data-types'\|'performance'	Appliquez les conseils de bonnes pratiques avant d'écrire un schéma	free

Coût et limites

Coût d'exécution

Quota d'API: Point de terminaison hébergé — limites de taux d'utilisation raisonnable
Tokens par appel: 300-1500 jetons par résultat de recherche
Monétaire: Gratuit
Astuce: Utilisez view_skill pour des conseils généraux, search_docs uniquement quand vous avez besoin d'une citation spécifique.

Sécurité

Permissions, secrets, portée

Portées minimales : Aucun — documentation uniquement

Stockage des identifiants : Aucun

Sortie de données : Vos requêtes vont à mcp.tigerdata.com

Ne jamais accorder : Rien à accorder ; pas d'accès à la base de données

Ce MCP n'exécute pas de SQL — associez-le au MCP postgres quand vous avez besoin d'exécuter des requêtes.

Dépannage

Erreurs courantes et correctifs

search_docs retourne des informations obsolètes

Épinglez la version : search_docs(query, version='17') pour les spécificités PG 17.

La connexion à mcp.tigerdata.com échoue

Vérifiez le pare-feu d'entreprise ; retombez sur l'installation du plugin Claude (local).

Vérifier : curl -I https://mcp.tigerdata.com/docs

view_skill retourne une sortie générique

Spécifiez le slug de compétence exactement — les slugs inconnus reviennent à des résumés génériques.

Alternatives

pg-aiguide vs autres

Alternative	Quand l'utiliser	Compromis
postgres MCP	Vous avez besoin d'exécuter du SQL, pas seulement de lire la documentation	Pas de couche de bonnes pratiques curées
Supabase MCP	Gestion de projet spécifique à Supabase	Verrouillé à Supabase

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills