dbt-mcp

Servidor MCP dbt

Este servidor MCP (Protocolo de Contexto de Modelo) proporciona herramientas para interactuar con dbt. Lea este blog para obtener más información.

Arquitectura

Configuración

1. Clonar el repositorio:

2. Instalar uv
3. Tarea de instalación
4. Ejecutar task install
5. Configurar variables de entorno:

Luego edite .env con sus variables de entorno específicas (consulte la sección Configuration del README.md ).

Configuración

El servidor MCP toma la siguiente configuración:

Grupos de herramientas

Configuración para la capa de descubrimiento y semántica

Configuración para herramientas remotas

Configuración para dbt CLI

Uso con clientes MCP

Después de realizar la instalación , podrá utilizar su servidor con un cliente MCP.

Esta configuración se añadirá al archivo de configuración del cliente correspondiente. Asegúrese de reemplazar las secciones dentro de <> :

<path-to-mcp-executable> depende de su sistema operativo:

• Linux y Mac: <path-to-this-directory>/.venv/bin/mcp
• PC: <path-to-this-directory>/.venv/Scripts/mcp

Escritorio de Claude

Siga estas instrucciones para crear el archivo claude_desktop_config.json y conectarse.

En Mac, puedes encontrar los registros de Claude Desktop en ~/Library/Logs/Claude .

Cursor

1. Abra el menú Cursor y seleccione Configuración → Configuración del cursor → MCP
2. Haga clic en "Agregar nuevo servidor MCP global".
3. Agregue la configuración anterior al archivo mcp.json proporcionado
4. Verifique que su conexión esté activa dentro de la pestaña MCP

Documentos del cursor MCP aquí como referencia

Código VS

1. Abra el menú Configuración (Comando + Coma) y seleccione la pestaña correcta en la parte superior de la página para su caso de uso
   • Workspace : configura el servidor en el contexto de su espacio de trabajo
   • User : configura el servidor en el contexto de su usuario
   • Nota para usuarios de WSL : Si usa VS Code con WSL, deberá configurar las opciones específicas de WSL. Ejecute el comando " Preferencias: Abrir configuración remota " desde la Paleta de comandos (F1) o seleccione la pestaña "Remoto" en el editor de configuración. La configuración del usuario local se reutiliza en WSL, pero se puede sobrescribir con la configuración específica de WSL. Configurar servidores MCP en la configuración del usuario local no funcionará correctamente en un entorno WSL.
2. Seleccione Funciones → Chat
3. Asegúrese de que "Mcp" esté Enabled

4. Haga clic en "Editar en settings.json" en "Mcp > Descubrimiento".
5. Agregue la configuración de su servidor ( dbt ) al archivo settings.json proporcionado como uno de los servidores:

<path-to-mcp-executable> depende de su sistema operativo:

• Linux y Mac: <path-to-this-directory>/.venv/bin/mcp
• PC: <path-to-this-directory>/.venv/Scripts/mcp

6. Puede iniciar, detener y configurar sus servidores MCP mediante:

• Ejecutar el comando MCP: List Servers desde la Paleta de comandos (Control + Comando + P) y seleccionar el servidor
• Utilizando las palabras clave en línea dentro del archivo settings.json

Documentos MCP de VS Code aquí como referencia

Herramientas

CLI de dbt

• build - Ejecuta modelos, pruebas, instantáneas y semillas en orden de dependencia
• compile : genera SQL ejecutable a partir de modelos, pruebas y análisis sin ejecutarlos
• docs - Genera documentación para el proyecto dbt
• ls (lista): enumera los recursos en el proyecto dbt, como modelos y pruebas
• parse : analiza y valida los archivos del proyecto para verificar la corrección de la sintaxis.
• run - Ejecuta modelos para materializarlos en la base de datos
• test : ejecuta pruebas para validar la integridad de los datos y el modelo
• show - Ejecuta una consulta en el almacén de datos

Permitir que su cliente utilice comandos dbt a través de esta herramienta MCP podría modificar sus modelos de datos, orígenes y objetos del almacén. Continúe solo si confía en el cliente y comprende el impacto potencial.

Capa semántica

• list_metrics - Recupera todas las métricas definidas
• get_dimensions : obtiene las dimensiones asociadas con las métricas especificadas
• get_entities : obtiene entidades asociadas con métricas específicas
• query_metrics : consulta métricas con agrupación, ordenación, filtrado y limitación opcionales

Descubrimiento

• get_mart_models - Obtiene todos los modelos de mart
• get_all_models - Obtiene todos los modelos
• get_model_details : obtiene detalles de un modelo específico
• get_model_parents : obtiene los nodos principales de un modelo específico
• get_model_children - Obtiene los modos secundarios de un modelo específico

Contribuyendo

¡Lea CONTRIBUTING.md para obtener instrucciones sobre cómo participar!