convez.ai
MCP ServerDados & AnalyticsIntermediário
mattijsdp

dbt-docs-MCP

mattijsdp/dbt-docs-mcp

Acesso ao grafo dbt via MCP para análise de linhagem e dependências

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece acesso estruturado ao grafo de dependências e metadados de projetos dbt, incluindo busca de nós, inspeção de atributos e rastreamento de linhagem em nível de coluna. Integra-se nativamente com Claude Desktop e Cursor para análise de pipelines de dados.

Instalação

$npx convez-ai mattijsdp/dbt-docs-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
23
Forks
8
Acompanhando
3
Saúde
42%
Último commit
há 1 ano
Versão
v0.0.1
Issues abertas
2
Contribuidores
3

Casos de uso

  • Rastrear linhagem de dados (upstream/downstream) em projetos dbt
  • Buscar modelos e colunas por nome ou conteúdo SQL compilado
  • Analisar impacto de mudanças em modelos dbt
  • Documentar automaticamente dependências e metadados do projeto

Veredito

Ferramenta sólida para engenheiros de dados que precisam navegar projetos dbt complexos via IA. O suporte a linhagem em nível de coluna é diferencial, embora a construção de índices seja computacionalmente pesada para projetos maiores.

README

A tradução para o português deste README ainda está na fila.

Verified on MseeP

Trust Score

dbt-docs-mcp

Model Context Protocol (MCP) server for interacting with dbt project metadata, including dbt Docs artifacts (manifest.json, catalog.json). This server exposes dbt graph information and allows querying node details, model/column lineage, and related metadata.

Key Functionality

This server provides tools to:

  • Search dbt Nodes:
    • Find nodes (models, sources, tests, etc.) by name (search_dbt_node_names).
    • Locate nodes based on column names (search_dbt_column_names).
    • Search within the compiled SQL code of nodes (search_dbt_sql_code).
  • Inspect Nodes:
    • Retrieve detailed attributes for any given node unique ID (get_dbt_node_attributes).
  • Explore Lineage:
    • Find direct upstream dependencies (predecessors) of a node (get_dbt_predecessors).
    • Find direct downstream dependents (successors) of a node (get_dbt_successors).
  • Column-Level Lineage:
    • Trace all upstream sources for a specific column in a model (get_column_ancestors).
    • Trace all downstream dependents of a specific column in a model (get_column_descendants).
  • Suggested extensions:
    • Tool that allows executing SQL queries.
    • Tool that retrieves table/view/column metadata directly from the database.
    • Tool to search knowledge-base.

Getting Started

  1. Prerequisites: Ensure you have Python installed and uv
  2. Clone the repo:
    git clone <repository-url>
    cd dbt-docs-mcp
    
  3. Optional: parse dbt manifest for column-level lineage:
    • Setup the required Python environment, e.g.:
    uv sync
    
    • Use the provided script scripts/create_manifest_cl.py and simply provide the path to your dbt manifest, dbt catalog and the desired output paths for your schema and column lineage file:
    python scripts/create_manifest_cl.py --manifest-path PATH_TO_YOUR_MANIFEST_FILE --catalog-path PATH_TO_YOUR_CATALOG_FILE --schema-mapping-path DESIRED_OUTPUT_PATH_FOR_SCHEMA_MAPPING --manifest-cl-path DESIRED_OUTPUT_PATH_FOR_MANIFEST_CL
    
    • Depending on your dbt project size, creating column-lineage can take a while (hours)
  4. Run the Server:
    • If your desired MCP client (Claude desktop, Cursor, etc.) supports mcp.json it would look as below:
    {
        "mcpServers": {
            "DBT Docs MCP": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "networkx,mcp[cli],rapidfuzz,dbt-core,python-decouple,sqlglot,tqdm",
                "mcp",
                "run",
                "/Users/mattijs/repos/dbt-docs-mcp/src/mcp_server.py"
            ],
            "env": {
                "MANIFEST_PATH": "/Users/mattijs/repos/dbt-docs-mcp/inputs/manifest.json",
                "SCHEMA_MAPPING_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/schema_mapping.json",
                "MANIFEST_CL_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/manifest_column_lineage.json"
            }
            }
        }
    }
    
Ver o original no GitHub

Bom para

Relacionados