PgLLens

Ce qu'il fait

PgLLens connecte n'importe quelle base de données PostgreSQL aux assistants IA via le Model Context Protocol. Il fournit aux modèles IA 19 outils conçus pour découvrir, comprendre et interroger vos données — entièrement en mode lecture seule. Au-delà de la simple liste de schémas, PgLLens extrait automatiquement les commentaires PostgreSQL, les contraintes, les énumérations, les triggers et les définitions de vues, rendant votre assistant IA conscient de votre schéma comme le serait votre équipe d'ingénierie. Vous pouvez également injecter un fichier de contexte de domaine en markdown simple pour intégrer des règles métier et des modèles de requête directement dans chaque réponse d'outil.

Outils

• query — Exécute des requêtes SELECT en lecture seule ; résultats sous forme de tableaux markdown avec nombre de lignes
• explain_query — EXPLAIN / EXPLAIN ANALYZE pour la planification de requêtes et l'optimisation des performances
• validate_query — Vérification de la syntaxe et des références sans exécution
• list_tables — Tables et vues avec descriptions et nombre de lignes
• describe_table — Types de colonnes, nullité, valeurs par défaut, PKs, FKs, commentaires
• schema_overview — Schéma complet de la base de données sous forme de résumé markdown
• get_ontology — Couche sémantique : contraintes CHECK, ENUMs, clés uniques, définitions de vues, index, triggers et contexte de domaine injecté
• get_relationships — Carte des relations FK ; sorties texte ou diagramme ER Mermaid
• get_sample_data — Lignes d'exemple (1–20) de n'importe quelle table
• search_columns — Recherche de colonnes inter-tables par motif de nom
• get_table_stats — Nombre de lignes, % de nulls, valeurs distinctes par colonne
• get_table_health — Historique vacuum/analyze, tuples morts, statistiques d'utilisation des index
• list_hypertables — Détails des hypertables TimescaleDB, intervalles de chunks, politiques de compression
• Plus list_functions, get_view_definition, get_function_source, list_extensions, list_roles, refresh_schema

Installation

Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "pgllens": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Démarrer le serveur d'abord :

docker run -p 3000:3000 -e DATABASE_URL="postgresql://user:pass@host:5432/mydb" dmdufresne/pgllens:latest

Avec OAuth :

{
  "mcpServers": {
    "pgllens": {
      "url": "http://localhost:3000/mcp",
      "authorizationUrl": "http://localhost:3000/oauth/authorize",
      "tokenUrl": "http://localhost:3000/oauth/token"
    }
  }
}

Hôtes supportés

Claude Desktop et Claude Code sont explicitement confirmés dans le README. Cursor, Windsurf et VS Code sont également listés comme clients compatibles.