cdp-pc — CDP Public Cloud control-plane MCP (read-only)

A Model Context Protocol server for monitoring the Cloudera CDP Public Cloud control plane in natural language, from any MCP client (Claude Code, 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 parsed result. This reuses your existing CLI install and ~/.cdp/credentials profiles — no separate auth, no cdpcli library coupling, no text scraping. Built on the official cloudera/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 cloudera org