READMEmain

Rancher MCP Server

A Model Context Protocol (MCP) server that exposes the Rancher Manager v2.x API to LLM clients. Built on the official mcp Python SDK (FastMCP) with async 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 /v3 management 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 /scale subresource.
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). The token 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-capable client (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.

rancher-mcp-server