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: MCP Manager

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

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

Client examples and docs

• Documentation landing page

• Guide

• Client configuration examples

• API reference

Development commands

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.