dbt-docs-mcp

dbt-docs-mcp

Model Context Protocol (MCP)-Server für die Interaktion mit dbt-Projektmetadaten, einschließlich dbt-Dokumentartefakten ( manifest.json , catalog.json ). Dieser Server stellt dbt-Diagramminformationen bereit und ermöglicht die Abfrage von Knotendetails, Modell-/Spaltenherkunft und zugehörigen Metadaten.

Schlüsselfunktionalität

Dieser Server bietet Tools für:

• Suche nach dbt-Knoten:
  • Suchen Sie Knoten (Modelle, Quellen, Tests usw.) nach Namen ( search_dbt_node_names ).
  • Suchen Sie Knoten basierend auf Spaltennamen ( search_dbt_column_names ).
  • Suche innerhalb des kompilierten SQL-Codes von Knoten ( search_dbt_sql_code ).
• Knoten prüfen:
  • Rufen Sie detaillierte Attribute für die eindeutige ID eines beliebigen Knotens ab ( get_dbt_node_attributes ).
• Abstammung erkunden:
  • Suchen Sie nach direkten Upstream-Abhängigkeiten (Vorgängern) eines Knotens ( get_dbt_predecessors ).
  • Suchen Sie nach direkten nachgelagerten abhängigen Elementen (Nachfolgern) eines Knotens ( get_dbt_successors ).
• Herkunft auf Spaltenebene:
  • Verfolgen Sie alle Upstream-Quellen für eine bestimmte Spalte in einem Modell ( get_column_ancestors ).
  • Verfolgen Sie alle nachgelagerten abhängigen Elemente einer bestimmten Spalte in einem Modell ( get_column_descendants ).
• Vorgeschlagene Erweiterungen:
  • Tool, das die Ausführung von SQL-Abfragen ermöglicht.
  • Tool, das Tabellen-/Ansichts-/Spaltenmetadaten direkt aus der Datenbank abruft.
  • Tool zum Durchsuchen der Wissensdatenbank.

Erste Schritte

1. Voraussetzungen: Stellen Sie sicher, dass Sie Python installiert haben und uv
2. Klonen Sie das Repo:
   git clone <repository-url> cd dbt-docs-mcp
3. Optional: Analysieren Sie das dbt-Manifest für die Herkunft auf Spaltenebene:
   • Richten Sie die erforderliche Python-Umgebung ein, zB: GXP2
   • Verwenden Sie das bereitgestellte Skript scripts/create_manifest_cl.py und geben Sie einfach den Pfad zu Ihrem dbt-Manifest, dbt-Katalog und die gewünschten Ausgabepfade für Ihr Schema und Ihre Spaltenherkunftsdatei an: GXP3
   • Abhängig von der Größe Ihres DBT-Projekts kann das Erstellen der Spaltenherkunft eine Weile dauern (Stunden).
4. Führen Sie den Server aus:
   • Wenn Ihr gewünschter MCP-Client (Claude Desktop, Cursor usw.) mcp.json unterstützt, würde er wie folgt aussehen: GXP4