dbt-docs-mcp

dbt-docs-mcp

Servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con los metadatos del proyecto dbt, incluyendo los artefactos de la documentación dbt ( manifest.json , catalog.json ). Este servidor expone la información del grafo dbt y permite consultar detalles de nodos, linaje de modelos/columnas y metadatos relacionados.

Funcionalidad clave

Este servidor proporciona herramientas para:

• Buscar nodos dbt:
  • Busque nodos (modelos, fuentes, pruebas, etc.) por nombre ( search_dbt_node_names ).
  • Localizar nodos según los nombres de columnas ( search_dbt_column_names ).
  • Busque dentro del código SQL compilado de los nodos ( search_dbt_sql_code ).
• Inspeccionar nodos:
  • Recupere atributos detallados para cualquier ID único de nodo determinado ( get_dbt_node_attributes ).
• Explorar Linaje:
  • Encuentre dependencias ascendentes directas (predecesores) de un nodo ( get_dbt_predecessors ).
  • Encuentra dependientes directos descendentes (sucesores) de un nodo ( get_dbt_successors ).
• Linaje a nivel de columna:
  • Rastrear todas las fuentes ascendentes para una columna específica en un modelo ( get_column_ancestors ).
  • Rastrear todos los dependientes descendentes de una columna específica en un modelo ( get_column_descendants ).
• Extensiones sugeridas:
  • Herramienta que permite ejecutar consultas SQL.
  • Herramienta que recupera metadatos de tabla/vista/columna directamente de la base de datos.
  • Herramienta para buscar en la base de conocimiento.

Empezando

1. Requisitos previos: asegúrese de tener Python instalado y uv
2. Clonar el repositorio:
   git clone <repository-url> cd dbt-docs-mcp
3. Opcional: analizar el manifiesto dbt para el linaje a nivel de columna:
   • Configurar el entorno Python requerido, por ejemplo: GXP2
   • Utilice el script proporcionado scripts/create_manifest_cl.py y simplemente proporcione la ruta a su manifiesto dbt, catálogo dbt y las rutas de salida deseadas para su esquema y archivo de linaje de columnas: GXP3
   • Dependiendo del tamaño de su proyecto dbt, la creación de un linaje de columnas puede tomar un tiempo (horas)
4. Ejecutar el servidor:
   • Si su cliente MCP deseado (Claude Desktop, Cursor, etc.) admite mcp.json, se vería así: GXP4