dbt

Servidor MCP do dbt

Este servidor MCP (Model Context Protocol) fornece diversas ferramentas para interagir com o dbt. Você pode usar este servidor MCP para fornecer a agentes de IA o contexto do seu projeto no dbt Core, dbt Fusion e dbt Platform.

Leia nossa documentação aqui para saber mais. Este post de blog fornece mais detalhes sobre o que é possível com o servidor MCP do dbt.

MCP Bundle experimental

Publicamos um Model Context Protocol Bundle experimental (dbt-mcp.mcpb) a cada versão para que clientes compatíveis com MCPB possam importar este servidor sem configuração adicional. Baixe o bundle nos assets da versão mais recente e siga a documentação da mcpb CLI da Anthropic para instalá-lo ou inspecioná-lo.

Feedback

Se você tiver comentários ou dúvidas, abra uma GitHub Issue ou junte-se a nós no Slack da comunidade no canal #tools-dbt-mcp.

Arquitetura

A arquitetura do servidor MCP do dbt permite que seu agente se conecte a uma variedade de ferramentas.

Ferramentas

SQL

Ferramentas para executar e gerar SQL na infraestrutura do dbt Platform.

• execute_sql: Executa SQL na infraestrutura do dbt Platform com suporte ao Semantic Layer.
• text_to_sql: Gera SQL a partir de linguagem natural usando o contexto do projeto.

Semantic Layer

Para saber mais sobre o dbt Semantic Layer, clique aqui.

• get_dimension_values: Obtém valores distintos para uma dimensão; opção de restringir a métricas específicas.
• get_dimensions: Obtém dimensões para as métricas especificadas.
• get_entities: Obtém entidades para as métricas especificadas.
• get_metrics_compiled_sql: Retorna o SQL compilado para métricas sem executar a consulta.
• list_metrics: Recupera todas as métricas definidas.
• list_saved_queries: Recupera todas as consultas salvas.
• query_metrics: Executa consultas de métricas com opções de filtragem e agrupamento.

Discovery

Para saber mais sobre a dbt Discovery API, clique aqui.

• get_all_macros: Recupera macros; opção de filtrar por pacote ou retornar apenas nomes de pacotes.
• get_all_models: Recupera o nome e a descrição de todos os modelos.
• get_all_sources: Obtém todas as fontes com status de atualização; opção de filtrar por nome de fonte.
• get_exposure_details: (obsoleto — use get_node_details em vez disso)
• get_exposures: Obtém todas as exposições (dashboards, apps ou análises downstream).
• get_lineage: Obtém um grafo de linhagem limitado com filtragem por tipo, profundidade e direção.
• get_macro_details: (obsoleto — use get_node_details em vez disso)
• get_mart_models: Recupera todos os modelos mart.
• get_model_children: (obsoleto — use get_lineage em vez disso)
• get_model_details: (obsoleto — use get_node_details em vez disso)
• get_model_health: Obtém sinais de saúde: status de execução, resultados de testes e atualização de fontes upstream.
• get_model_parents: (obsoleto — use get_lineage em vez disso)
• get_model_performance: Obtém o histórico de execução de um modelo; opção de incluir resultados de testes.
• get_node_details: Obtém detalhes completos de qualquer tipo de recurso do dbt (model, source, exposure, test, seed, snapshot, macro, semantic_model).
• get_related_models: Encontra modelos semelhantes usando busca semântica.
• get_seed_details: (obsoleto — use get_node_details em vez disso)
• get_semantic_model_details: (obsoleto — use get_node_details em vez disso)
• get_snapshot_details: (obsoleto — use get_node_details em vez disso)
• get_source_details: (obsoleto — use get_node_details em vez disso)
• get_test_details: (obsoleto — use get_node_details em vez disso)
• search: [Alpha] Pesquisa recursos em todo o projeto dbt (não disponível em geral).
• search_public_mesh_models: Encontra modelos públicos do dbt Mesh entre projetos e confirma a identidade do produtor para que você possa criar um ref entre projetos verificado (apenas configurações multiprojeto).

dbt CLI

Permitir que seu cliente utilize comandos dbt por meio das ferramentas MCP pode modificar seus modelos de dados, fontes e objetos do warehouse. Prossiga apenas se você confiar no cliente e compreender o impacto potencial.

• build: Executa modelos, testes, snapshots e seeds na ordem do DAG.
• clone: Clona os nós selecionados do estado especificado para o(s) schema(s) de destino.
• compile: Gera SQL executável a partir de modelos/testes/análises; útil para validar a lógica Jinja.
• docs: Gera documentação para o projeto dbt.
• get_lineage_dev: Recupera a linhagem do manifest.json local com filtragem por tipo e profundidade.
• get_node_details_dev: Recupera detalhes de nós do manifest.json local (modelos, seeds, snapshots, fontes).
• list: Lista recursos no projeto dbt por tipo com suporte a seletores.
• parse: Analisa e valida os arquivos do projeto quanto à correção sintática.
• run: Executa modelos para materializá-los no banco de dados.
• show: Executa SQL no banco de dados e retorna os resultados.
• test: Executa testes para validar a integridade dos dados e dos modelos.

Admin API

Para saber mais sobre a dbt Administrative API, clique aqui.

• cancel_job_run: Cancela um job em execução.
• get_job_details: Obtém a configuração do job, incluindo gatilhos, agendamento e comandos dbt.
• get_job_run_artifacts: Baixa um artefato específico de uma execução de job; artefatos grandes retornam uma mensagem de orientação para tentar novamente com um jq_filter; oferece suporte a filtragem jq para extração direcionada.
• get_job_run_details: Obtém detalhes da execução, incluindo status, tempo, etapas e artefatos.
• get_job_run_error: Obtém detalhes de erros e/ou avisos de uma execução de job; opção de incluir avisos ou mostrar apenas avisos.
• list_job_run_artifacts: Lista os artefatos disponíveis de uma execução de job.
• list_jobs: Lista jobs em uma conta do dbt Platform; opção de filtrar por projeto ou ambiente.
• list_jobs_runs: Lista execuções de jobs; opção de filtrar por job, status ou ordenar por campo.
• list_projects: Lista todos os projetos na conta do dbt Platform.
• retry_job_run: Tenta novamente uma execução de job com falha.
• trigger_job_run: Dispara uma execução de job; opção de substituir a branch git, o schema ou outras configurações.

dbt Codegen

Estas ferramentas ajudam a automatizar a geração de código boilerplate para arquivos de projeto dbt.

• generate_model_yaml: Gera YAML de modelo com colunas; opção de herdar descrições upstream.
• generate_source: Gera YAML de fonte introspectando schemas do banco de dados; opção de incluir colunas.
• generate_staging_model: Gera o SQL do modelo de staging a partir de uma tabela de origem.

dbt LSP

Um conjunto de ferramentas que aproveitam o mecanismo Fusion para compilação avançada de SQL e análise de linhagem em nível de coluna.

• fusion.compile_sql: Compila SQL no contexto do projeto via dbt Platform.
• fusion.get_column_lineage: Rastreia a linhagem em nível de coluna via dbt Platform.
• get_column_lineage: Rastreia a linhagem em nível de coluna localmente (requer dbt-lsp via dbt Labs VSCE).

Product Docs

Ferramentas para pesquisar e buscar conteúdo da documentação oficial do dbt em docs.getdbt.com.

• get_product_doc_pages: Busca o conteúdo Markdown completo de uma ou mais páginas do docs.getdbt.com por caminho ou URL.
• search_product_docs: Pesquisa no docs.getdbt.com por páginas correspondentes a uma consulta; retorna títulos, URLs e descrições classificados por relevância. Use get_product_doc_pages para buscar o conteúdo completo.

Metadados do servidor MCP

Estas ferramentas fornecem informações sobre o próprio servidor MCP.

• get_mcp_server_branch: Retorna a branch git atual do servidor MCP do dbt em execução.
• get_mcp_server_version: Retorna a versão atual do servidor MCP do dbt.

Exemplos

Comumente, você conectará o servidor MCP do dbt a um produto de agente como Claude ou Cursor. No entanto, se você tiver interesse em criar seu próprio agente, confira o diretório de exemplos para saber como começar.

Dependências

As dependências são fixadas em versões específicas e não são atualizadas automaticamente. Apenas atualizações de dependências relacionadas à segurança são enviadas por meio de pull requests automatizados.

Contribuindo

Leia CONTRIBUTING.md para instruções sobre como participar!

Consulte entradas de ferramentas e contexto resolvido para declarações de seletores e contratos de mapeamento de contexto.