cdp-pc — CDP Public Cloud control-plane MCP (read-only)
A Model Context Protocol server for monitoring theCloudera CDP Public Cloud control plane in natural language, from any MCP client (ClaudeCode, Claude Desktop, …).
It fills a gap: existing Cloudera MCPs cover the data plane (Iceberg/Impala), streaming(SMM/SSB/NiFi), or private-cloud Cloudera Manager — none cover the CDP-PC control plane(environments / datalake / datahub / DW / DE / ML lifecycle).
v0.1 is read-only. Every tool only ever runs list- / describe- / get- verbs —enforced in code (cdp.py), so there is zero risk of mutating a customer environment.
How it works
Each tool shells out to the installed cdp CLI with --output json and returns the parsedresult. This reuses your existing CLI install and ~/.cdp/credentials profiles — no separateauth, no cdpcli library coupling, no text scraping. Built on the officialcloudera/minimcp framework.
Tools
| Tool | cdp call |
Required arg |
|---|---|---|
list_environments |
environments list-environments |
— |
describe_environment |
environments describe-environment |
environment_name |
list_datahubs |
datahub list-clusters |
— |
describe_datahub |
datahub describe-cluster |
cluster_name |
list_datalakes |
datalake list-datalakes |
— |
describe_datalake |
datalake describe-datalake |
datalake_name |
list_dw_clusters |
dw list-clusters |
— |
list_virtual_warehouses |
dw list-vws |
cluster_id (from list_dw_clusters) |
list_de_services |
de list-services |
— |
list_ml_workspaces |
ml list-workspaces |
— |
whoami |
iam get-user |
— |
Every tool also takes an optional profile (a profile name from ~/.cdp/credentials,default default).
Setup
Requires the cdp CLI installed and configured (~/.cdp/credentials).
cd cdp-pc-mcp
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
Register in Claude Code
BASE="$(pwd)" # run this from the repo root
claude mcp add cdp-pc -s user -e "PYTHONPATH=$BASE/src" -- "$BASE/.venv/bin/python" -m cdp_pc_mcp.stdio_main
Then start a new Claude Code session and try: "list my CDP environments","what datahubs do I have and their status", "describe environment my-cdp-env".
Quick self-test (no MCP client)
. .venv/bin/activate && export PYTHONPATH="$PWD/src"
python -c "from cdp_pc_mcp.cdp import run_cdp; print(run_cdp('iam','get-user')['user']['email'])"
Roadmap (v0.2+)
- Operations with guardrails: start/stop environment·datahub·ml, DW scaling
- HTTP transport for packaged customer delivery
- Richer diagnostics; packaging for contribution to the
clouderaorg
