Skip to main content
Glama
Jasonrve

rancher-mcp

by Jasonrve
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

rancher-mcp

A polished TypeScript MCP server for Rancher workflows.

It exposes the Rancher tool surface as a standalone MCP service, forwards caller identity when available, and falls back to configured Rancher credentials when needed. The repo includes tests, a documentation site, and GitHub Pages publishing.

Live docs

  • GitHub Pages site: https://jasonrve.github.io/rancher-mcp/

  • Docs source: docs/

  • Brand assets: docs/public/

Related MCP server: thalovant-mcp

Why this exists

Rancher users often need the tool surface without the surrounding operator/runtime package. rancher-mcp keeps the useful Rancher and Fleet actions, but packages them as a focused MCP server that is easier to run locally, automate, and connect to agent clients.

What it does

  • exposes Rancher cluster, project, namespace, access-control, and Fleet tools

  • supports HTTP and stdio transports

  • forwards the incoming Authorization header to Rancher

  • falls back to configured Rancher credentials when no header is present

  • includes Vitest coverage for the tool catalog, auth, executor, and health route

  • ships a documentation site with client setup examples

Tool groups

Group

Examples

What it is for

Rancher core

cluster_list, project_create, namespace_create

Everyday cluster, project, and namespace workflows

Access control

project_member_create, principal_get_by_name

Finding principals and binding them to projects

Fleet

create_fleet_gitrepo, update_fleet_gitrepo, force_fleet_sync

GitOps repo and sync management

Quick start

npm install
npm test
npm run build
npm run dev

Beta publishing and install

This repository is set up for a beta release channel on npm.

  • publish workflow: .github/workflows/publish-beta.yml

  • npm dist-tag: beta

  • local run via npx after publishing:

npx -y rancher-mcp@beta

Configuration

Variable

Purpose

RANCHER_URL

Base Rancher URL

RANCHER_TOKEN

Fallback bearer token

RANCHER_USERNAME

Fallback basic-auth username

RANCHER_PASSWORD

Fallback basic-auth password

RANCHER_MCP_TRANSPORT

http or stdio

RANCHER_MCP_PATH

HTTP route for MCP traffic

PORT

HTTP listen port

Client examples and docs

Development commands

Command

Description

npm run dev

Start the server

npm run test

Run Vitest

npm run build

Compile TypeScript

npm run docs:dev

Start the docs site

npm run docs:build

Build the docs site

npm run docs:preview

Preview the docs site

Project layout

.
├── src/
├── tests/
├── docs/
├── dist/
├── package.json
└── README.md

Source project

This repository mirrors the Rancher-side MCP surface from the original C# implementation.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Manager

    daniel3303
    A
    license
    Not graded
    quality
    B
    maintenance
    Self-hosted MCP proxy and aggregation platform. Register multiple upstream MCP servers and expose them through a single unified endpoint with namespace routing, multi-transport support (HTTP/SSE, stdio, OpenAPI→MCP), per-tool overrides, and a web admin UI.
    17
    MIT
  • thalovant-mcp by thalovant

    thalovant-mcpofficial

    thalovant
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP server for Thalovant control-plane and hub runtime APIs, supporting local stdio and remote Streamable HTTP with authentication and per-principal credentials.
    1,119 npm
    MIT

  • mcp-server

    gwanghun-choi
    F
    license
    Not graded
    quality
    C
    maintenance
    A universal MCP server for registering internal, external, and OpenAPI-based APIs as MCP tools. It exposes them to MCP clients via Streamable HTTP and provides admin portal, RBAC/session auth, credential injection, and audit logging.
    -

  • dockhand-mcp

    craibo
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP sidecar server that exposes Dockhand's container, image, volume, network, and stack management as MCP tools over Streamable HTTP, enabling MCP clients to manage Docker resources through Dockhand's REST API.
    MIT