Rancher MCP Server
A Model Context Protocol (MCP) server that exposes the Rancher Manager v2.x API to LLM clients.
README
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.
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.