MCP (model context protocol) server for interacting with dbt Docs
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.
This server provides tools to:
search_dbt_node_names
).search_dbt_column_names
).search_dbt_sql_code
).get_dbt_node_attributes
).get_dbt_predecessors
).get_dbt_successors
).get_column_ancestors
).get_column_descendants
).git clone <repository-url>
cd dbt-docs-mcp
uv sync
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
{
"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"
}
}
}
}