dbt
Serveur MCP par dbt Labs
Give assistants dbt project context: models, lineage, Semantic Layer metrics, Discovery API data and dbt CLI commands.
Installer dbt
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
DBT_PROJECT_DIRPath to your dbt project.DBT_PATHPath to the dbt executable.
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/dbtPrésentation
Connects an AI assistant to dbt Core, dbt Fusion and the dbt platform. It can list models, sources and exposures, trace lineage, query Semantic Layer metrics, run dbt CLI commands, generate YAML and staging models, manage platform jobs and runs, and fetch pages from the dbt docs.
It runs locally over stdio with uvx dbt-mcp. The CLI tools need DBT_PROJECT_DIR and DBT_PATH. Semantic Layer, Discovery, Admin API and SQL tools need a dbt platform host (DBT_HOST) and a token (DBT_TOKEN). CLI commands such as run and build can modify warehouse objects, so use them only with a client you trust.
Ce que vous pouvez faire
- Query Semantic Layer metrics, dimensions and entities
- Browse models, sources, macros and exposures via the Discovery API
- Trace model and column-level lineage
- Run dbt build, run, test, compile and show from the CLI
- Generate source YAML, model YAML and staging models
- List, trigger, retry and cancel dbt platform jobs and runs
- Search and fetch official dbt documentation pages
Outils
Les serveurs locaux présentent leurs outils une fois lancés, et celui-ci ne publie pas sa liste à l’avance. Votre client les affiche après l’ajout.
Exemples de prompts
List all metrics defined in our dbt Semantic Layer
Show the upstream and downstream lineage of the orders model
Run dbt test for the staging models and summarize failures
Generate staging model SQL for the raw customers source table
Configuration
Chaque client lance dbt sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio dbt --env "DBT_PROJECT_DIR=<YOUR_DBT_PROJECT_DIR>" --env "DBT_PATH=<YOUR_DBT_PATH>" -- uvx dbt-mcp- Démarrez Claude Code et tapez
/mcp. dbt devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"dbt": {
"command": "uvx",
"args": [
"dbt-mcp"
],
"env": {
"DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>",
"DBT_PATH": "<YOUR_DBT_PATH>"
}
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.
Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"dbt": {
"command": "uvx",
"args": [
"dbt-mcp"
],
"env": {
"DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>",
"DBT_PATH": "<YOUR_DBT_PATH>"
}
}
}
}Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
VS Code
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"dbt","type":"stdio","command":"uvx","args":["dbt-mcp"],"env":{"DBT_PROJECT_DIR":"<YOUR_DBT_PROJECT_DIR>","DBT_PATH":"<YOUR_DBT_PATH>"}}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"dbt": {
"type": "stdio",
"command": "uvx",
"args": [
"dbt-mcp"
],
"env": {
"DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>",
"DBT_PATH": "<YOUR_DBT_PATH>"
}
}
}
}Nécessite uv (Python) sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"dbt": {
"command": "uvx",
"args": [
"dbt-mcp"
],
"env": {
"DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>",
"DBT_PATH": "<YOUR_DBT_PATH>"
}
}
}
}- Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.
Devin Desktop est le nouveau nom de Windsurf.
Codex
codex mcp add dbt --env "DBT_PROJECT_DIR=<YOUR_DBT_PROJECT_DIR>" --env "DBT_PATH=<YOUR_DBT_PATH>" -- uvx dbt-mcpOu modifiez directement ~/.codex/config.toml :
[mcp_servers.dbt]
command = "uvx"
args = ["dbt-mcp"]
env = { DBT_PROJECT_DIR = "<YOUR_DBT_PROJECT_DIR>", DBT_PATH = "<YOUR_DBT_PATH>" }Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Gemini CLI
gemini mcp add -e "DBT_PROJECT_DIR=<YOUR_DBT_PROJECT_DIR>" -e "DBT_PATH=<YOUR_DBT_PATH>" dbt uvx dbt-mcpCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"dbt": {
"command": "uvx",
"args": [
"dbt-mcp"
],
"env": {
"DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>",
"DBT_PATH": "<YOUR_DBT_PATH>"
}
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
FAQ
Puis-je coller mcp.tc/i/dbt dans mon client MCP ?
Non. dbt tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx dbt-mcp.
dbt a-t-il besoin d’une clé API ?
Non. Il lit DBT_PROJECT_DIR et DBT_PATH dans son environnement ; les étapes de configuration montrent où les définir.
dbt est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec uvx dbt-mcp, qui nécessite uv (Python).
Que peut faire dbt ?
Vous pouvez query Semantic Layer metrics, dimensions and entities, browse models, sources, macros and exposures via the Discovery API et trace model and column-level lineage.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de dbt (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page.
Intégrer
Affichez dbt dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
Badge pour README
[](https://mcp.tc/i/dbt)<a href="https://mcp.tc/i/dbt"><img src="https://mcp.tc/i/dbt/badge.svg" alt="dbt on mcp.tc" height="20"></a>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/dbt.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.
iframe
<iframe src="https://mcp.tc/embed/dbt" title="dbt on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/dbt.jsonmcp.tc n’est pas affilié à dbt Labs. Cette page a été construite à partir des métadonnées publiques de dbt, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche.