Skip to main content
Glama
Sign In
rancher-mcp

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: mcp-server

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • thalovant-mcp

      thalovant-mcpofficial

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

    • mcp-server

      gwanghun-choi
      F
      license
      Not graded
      quality
      D
      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
      B
      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.
      3
      MIT

    • Balena MCP

      kieksme
      A
      license
      B
      quality
      B
      maintenance
      Enables managing Balena fleets, devices, releases, variables, tags, teams, and organizations from MCP clients, locally over stdio or remotely over Streamable HTTP.
      41
      1
      GPL 3.0