Capability-aware MCP server for Rancher. Cluster, workload, RBAC, and monitoring exposed to Claude.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add rancher --env RANCHER_URL='<RANCHER_URL>' --env RANCHER_TOKEN='<RANCHER_TOKEN>' --env RANCHER_INSTANCES_JSON='<RANCHER_INSTANCES_JSON>' -- uvx rancher-mcp~/.codex/config.toml
[mcp_servers.rancher]
command = "uvx"
args = ["rancher-mcp"]
env = { RANCHER_URL = "<RANCHER_URL>", RANCHER_TOKEN = "<RANCHER_TOKEN>", RANCHER_INSTANCES_JSON = "<RANCHER_INSTANCES_JSON>" }
# codex mcp add rancher --env RANCHER_URL='<RANCHER_URL>' --env RANCHER_TOKEN='<RANCHER_TOKEN>' --env RANCHER_INSTANCES_JSON='<RANCHER_INSTANCES_JSON>' -- uvx rancher-mcp~/.cursor/mcp.json
{
"mcpServers": {
"rancher": {
"command": "uvx",
"args": [
"rancher-mcp"
],
"env": {
"RANCHER_URL": "<RANCHER_URL>",
"RANCHER_TOKEN": "<RANCHER_TOKEN>",
"RANCHER_INSTANCES_JSON": "<RANCHER_INSTANCES_JSON>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"rancher": {
"type": "stdio",
"command": "uvx",
"args": [
"rancher-mcp"
],
"env": {
"RANCHER_URL": "<RANCHER_URL>",
"RANCHER_TOKEN": "<RANCHER_TOKEN>",
"RANCHER_INSTANCES_JSON": "<RANCHER_INSTANCES_JSON>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"rancher": {
"command": "uvx",
"args": [
"rancher-mcp"
],
"env": {
"RANCHER_URL": "<RANCHER_URL>",
"RANCHER_TOKEN": "<RANCHER_TOKEN>",
"RANCHER_INSTANCES_JSON": "<RANCHER_INSTANCES_JSON>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"rancher": {
"command": "uvx",
"args": [
"rancher-mcp"
],
"env": {
"RANCHER_URL": "<RANCHER_URL>",
"RANCHER_TOKEN": "<RANCHER_TOKEN>",
"RANCHER_INSTANCES_JSON": "<RANCHER_INSTANCES_JSON>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"rancher": {
"command": "uvx",
"args": [
"rancher-mcp"
],
"env": {
"RANCHER_URL": "<RANCHER_URL>",
"RANCHER_TOKEN": "<RANCHER_TOKEN>",
"RANCHER_INSTANCES_JSON": "<RANCHER_INSTANCES_JSON>"
}
}
}
}Environment variables
RANCHER_URLRANCHER_TOKENRANCHER_INSTANCES_JSON
Replace the placeholders with your own credentials and keep them out of version control.