Loading...

Exposes dbt project metadata (manifest, catalog) via MCP, enabling search, lineage exploration, and node inspection for dbt projects.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
Exposes dbt project metadata (manifest, catalog) via MCP, enabling search, lineage exploration, and node inspection for dbt projects.
This server is relatively safe for read-only access to dbt metadata. The primary risk lies in the exposure of sensitive information within the dbt project itself. Ensure the MANIFEST_PATH is secured and dbt project descriptions are sanitized.
Performance depends on the size of the dbt project and the complexity of the queries. Column-level lineage can be computationally intensive.
The primary cost is the computational resources required to run the server. There are no external API costs.
{
"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"
}
}
}
}search_dbt_node_namesFinds dbt nodes by name.
Read-only search operation.
search_dbt_column_namesLocates dbt nodes based on column names.
Read-only search operation.
search_dbt_sql_codeSearches within the compiled SQL code of dbt nodes.
Read-only search operation.
get_dbt_node_attributesRetrieves detailed attributes for a given dbt node ID.
Read-only retrieval of node attributes.
get_dbt_predecessorsFinds direct upstream dependencies of a dbt node.
Read-only lineage exploration.
get_dbt_successorsFinds direct downstream dependents of a dbt node.
Read-only lineage exploration.
get_column_ancestorsTraces all upstream sources for a specific column in a model.
Read-only column-level lineage tracing.
get_column_descendantsTraces all downstream dependents of a specific column in a model.
Read-only column-level lineage tracing.
Environment Variable
This server is relatively safe for read-only access to dbt metadata. The primary risk lies in the exposure of sensitive information within the dbt project itself. Ensure the MANIFEST_PATH is secured and dbt project descriptions are sanitized.
The server operates in a read-only mode, limiting the risk of unintended modifications. Autonomy is limited to the scope of metadata exploration.
Production Tip
Monitor the server's resource usage and ensure the dbt manifest and catalog files are regularly updated.
The server requires `manifest.json` and `catalog.json` generated by dbt.
You need to re-run `dbt docs generate` to update the `manifest.json` and `catalog.json` files, and then restart the server.
Currently, authentication is limited to securing the file system where the manifest and catalog files are stored. No built-in authentication.
No, this server is read-only and only provides access to dbt metadata.
Configuration is primarily done through environment variables, such as `MANIFEST_PATH`, `SCHEMA_MAPPING_PATH`, and `MANIFEST_CL_PATH`.
These files are used to enable column-level lineage and are generated using the provided `create_manifest_cl.py` script.
Yes, the server can be extended by modifying the `mcp_server.py` file and adding new MCP tools.