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