Rancher MCP Server
Interacts with the Rancher Manager v2.x API to manage clusters, projects, nodes, Kubernetes resources (namespaces, pods, deployments, logs), scale deployments, list catalog apps, and generate kubeconfigs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Rancher MCP Serverlist my clusters"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
/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.
Related MCP server: MCP Server Sample
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 Manager base URL (no trailing slash). |
|
| API token in | (required) |
| Verify TLS certificates. |
|
| HTTP timeout in seconds. |
|
Running
rancher-mcpThe 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 all managed clusters. |
| Fetch one cluster by ID. |
| List projects, optionally scoped to a cluster. |
| List nodes in a cluster. |
| List Kubernetes namespaces via the Rancher proxy. |
| List pods (optionally namespace-scoped). |
| List Deployments (optionally namespace-scoped). |
| Tail pod logs. |
| Scale a Deployment via the |
| List catalog apps installed in a cluster. |
| 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 testsLicense
MIT License - see LICENSE file for details.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/LokiMCPUniverse/rancher-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server