Rancher MCP Server
A Model Context Protocol (MCP) server that exposes the Rancher Manager v2.xAPI to LLM clients. Built on the official mcp Python SDK (FastMCP) withasync HTTP via httpx and settings management via pydantic-settings.
Features
- Bearer-token authentication using a Rancher API key (
token-xxx:yyy...). - Cluster, project, and node discovery against the
/v3management API. - Kubernetes resource queries (
namespaces,pods,deployments, pod logs)through Rancher's/k8s/clusters/{cluster_id}proxy. - Deployment scaling via strategic-merge PATCH on the
/scalesubresource. - Catalog app listing and on-demand kubeconfig generation.
Requirements
- Python 3.10+
- A Rancher Manager instance reachable over HTTPS.
- An API token generated from the Rancher UI (Account -> API & Keys). Thetoken must be passed in the full
token-xxx:yyy...form.
Installation
pip install -e ".[dev]"
Configuration
Configure the server through environment variables (prefix RANCHER_) or a.env file in the working directory:
| Variable | Description | Default |
|---|---|---|
RANCHER_BASE_URL |
Rancher Manager base URL (no trailing slash). | https://localhost |
RANCHER_API_TOKEN |
API token in token-xxx:yyy... format. |
(required) |
RANCHER_VERIFY_SSL |
Verify TLS certificates. | true |
RANCHER_TIMEOUT |
HTTP timeout in seconds. | 60 |
Running
rancher-mcp
The server speaks MCP over stdio and can be wired into any MCP-capableclient (Claude Desktop, Cursor, custom agents, and so on).
Tools
| Tool | Description |
|---|---|
list_clusters |
List all managed clusters. |
get_cluster |
Fetch one cluster by ID. |
list_projects |
List projects, optionally scoped to a cluster. |
list_nodes |
List nodes in a cluster. |
list_namespaces |
List Kubernetes namespaces via the Rancher proxy. |
list_pods |
List pods (optionally namespace-scoped). |
list_deployments |
List Deployments (optionally namespace-scoped). |
get_pod_logs |
Tail pod logs. |
scale_deployment |
Scale a Deployment via the /scale subresource. |
list_catalog_apps |
List catalog apps installed in a cluster. |
create_kubeconfig |
Generate a kubeconfig for a cluster. |
Development
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest -x --tb=short
ruff check src tests
License
MIT License - see LICENSE file for details.
