Каталог MCP
mrostamii
mrostamii/rancher-mcp-server

mrostamii/rancher-mcp-server

MCP-сервер для управления Rancher, Harvester HCI и Fleet GitOps через единый API. Работает с мультикластерным Kubernetes, виртуальными машинами, Helm-релизами и GitOps-репозиториями. По умолчанию т...

README

49 инструментов

Установить сервер

rancher-mcp-server

Model Context Protocol (MCP) server for the Rancher ecosystem: multi-cluster Kubernetes, Harvester HCI (VMs, storage, networks), and Fleet GitOps.

Demo

A walkthrough of how this MCP server works (example in Cursor).

https://github.com/user-attachments/assets/7d8fb814-e504-47b4-956d-28f43aeea3b8

Features

Harvester toolset: List/get VMs, images, volumes, networks, hosts; VM actions; addon list/switch (enable/disable)
Rancher toolset: Clusters and projects via Steve (management proxy); Norman management API (/v3) for schemas, users, tokens, auth configs, global role bindings, cluster registration tokens, node drivers, cloud credentials, catalogs, cluster repos, feature flags, settings, audit (when exposed); support bundle and generic actions when writes are enabled
Kubernetes toolset: List/get/create/patch/delete resources by apiVersion/kind; describe (resource + events), events, capacity
Helm toolset: List/get/history of releases; install, upgrade, rollback, uninstall; repo list
Fleet toolset: GitRepo list/get/create; Bundle list; Fleet cluster list; drift detection
Rancher APIs: Same Bearer token for Steve (/k8s/clusters/...) and Norman (/v3/...); no CLI wrappers
Security: Read-only default, disable-destructive, sensitive data masking (Norman token/credential fields redacted unless --show-sensitive-data)
Config: Flags, env (RANCHER_MCP_*), or file (YAML/TOML)

fleet_bundle_listвнешний мир

Выводит список Fleet Bundles (юниты развёртывания из GitRepos)

Параметры

continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (default: fleet-default)

fleet_cluster_listвнешний мир

Перечисляет кластеры Fleet (подчинённые кластеры, зарегистрированные в Fleet).

Параметры

continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (default: fleet-default)

fleet_drift_detectвнешний мир

Сообщить о дрейфе Fleet: BundleDeployments со статусом Modified (ресурсы изменены вне GitOps)

Параметры

formatstring
Output format: json, table (default: json)
gitrepostring
Filter by GitRepo name (optional)
limitnumber
Max items (default: 100)
namespacestring
Namespace (default: fleet-default)

fleet_gitrepo_getвнешний мир

Получает подробную информацию для одного Fleet GitRepo.

Параметры

formatstring
Output format: json, table (default: json)
namestringобязательный
GitRepo name
namespacestring
Namespace (default: fleet-default)

fleet_gitrepo_listвнешний мир

Получает список Fleet GitRepos (источники GitOps)

Параметры

continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (default: fleet-default)

harvester_addon_listвнешний мир

Выводит список аддонов Harvester с указанием, включены они или отключены.

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page; only when namespace is specified)
formatstring
Output format: json, table (default: json)
limitnumber
Max items per namespace (default: 100)
namespacestring
Namespace (empty = all common addon namespaces: harvester-system, cattle-logging-system, cattle-monitoring-system, kube-system)

harvester_host_listвнешний мир

Выводит список хостов Harvester (узлов) с указанием режима обслуживания и состояния дисков.

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)

harvester_image_listвнешний мир

Перечисляет образы виртуальных машин Harvester (VirtualMachineImage) с ходом загрузки

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (empty = all)

harvester_network_listвнешний мир

Выводит список VLAN-сетей Harvester (NetworkAttachmentDefinition)

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (empty = all)

harvester_settingsвнешний мир

Перечисляет или получает настройки кластера Harvester (backup-target, auto-disk-provision-paths и т.д.)

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page; list mode only)
formatstring
Output format: json, table (default: json)
limitnumber
Max items when listing (default: 100)
namestring
Setting name (empty = list all)

harvester_subnet_listвнешний мир

Перечисляет подсети KubeOVN (требуется аддон kubeovn-operator). Подсети определяют CIDR сетей виртуальных машин и связаны с Networks через provider.

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)

harvester_vm_getвнешний мир

Получает одну виртуальную машину с полной спецификацией и статусом (метрики, диски, сети).

Параметры

clusterstringобязательный
Harvester cluster ID
formatstring
Output format: json, table (default: json)
namestringобязательный
VM name
namespacestringобязательный
Namespace

harvester_vm_listвнешний мир

Перечисляет виртуальные машины во всех кластерах Harvester с указанием статуса, IP, узла, CPU/памяти.

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items to return (default: 100)
namespacestring
Namespace (empty = all namespaces)

harvester_volume_listвнешний мир

Выводит список PersistentVolumeClaims (томов Longhorn) с размером и состоянием.

Параметры

clusterstringобязательный
Harvester cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)
namespacestring
Namespace (empty = all)

harvester_vpc_listвнешний мир

Выводит список VPC KubeOVN (требуется включенный аддон kubeovn-operator)

Параметры

clusterstringобязательный
Harvester cluster ID (where KubeOVN runs)
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)

kubernetes_capacityвнешний мир

Выводит сводку по ёмкости кластера и выделяемым ресурсам из Nodes.

Параметры

clusterstringобязательный
Cluster ID
formatstring
Output format: json, table (default: json)

kubernetes_describeвнешний мир

Получает ресурс Kubernetes и его последние события (вывод в стиле describe)

Параметры

api_versionstringобязательный
apiVersion (e.g. v1, apps/v1)
clusterstringобязательный
Cluster ID
events_limitnumber
Max events to include (default: 20)
formatstring
Output format: json, table (default: json)
kindstringобязательный
Kind (e.g. Pod, Deployment)
namestringобязательный
Resource name
namespacestring
Namespace (for namespaced resources)

kubernetes_eventsвнешний мир

Перечисляет события Kubernetes в пространстве имён (опционально отфильтрованные по involvedObject).

Параметры

clusterstringобязательный
Cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
involved_object_namestring
Filter by involvedObject.name
limitnumber
Max events (default: 50)
namespacestringобязательный
Namespace

kubernetes_getвнешний мир

Получает один ресурс Kubernetes по apiVersion, kind, namespace, name.

Параметры

api_versionstringобязательный
apiVersion (e.g. v1, apps/v1)
clusterstringобязательный
Cluster ID
formatstring
Output format: json, table (default: json)
kindstringобязательный
Kind (e.g. Pod, Deployment)
namestringобязательный
Resource name
namespacestring
Namespace (required for namespaced resources)

kubernetes_listвнешний мир

Перечисляет ресурсы Kubernetes по apiVersion и kind (например, v1 Pod, apps/v1 Deployment).

Параметры

api_versionstringобязательный
apiVersion (e.g. v1, apps/v1)
clusterstringобязательный
Cluster ID
continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
kindstringобязательный
Kind (e.g. Pod, Deployment)
label_selectorstring
Label selector
limitnumber
Max items (default: 100)
namespacestring
Namespace (empty = all for namespaced; omit for cluster-scoped)

kubernetes_logsвнешний мир

Получает последние логи из контейнера пода (только хвост; без отслеживания). Используется для отладки. Кластер - идентификатор кластера Rancher.

Параметры

clusterstringобязательный
Cluster ID
containerstring
Container name (optional; default is first/only container)
namespacestringобязательный
Namespace of the pod
podstringобязательный
Pod name
since_secondsnumber
Only logs from last N seconds (optional)
tail_linesnumber
Number of lines from the end (default: 100, max practical ~1000)

rancher_audit_log_listвнешний мир

Пытается выполнить GET /v3/auditlogs (Norman). Многие сборки Rancher возвращают 404 (не раскрыто) или 405 (GET не поддерживается); в таких случаях инструмент возвращает JSON с _source_unavailable, _http_status и пояснительным _note (например, GET not supported for 405) вместо того, чтобы завершиться ошибкой.

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_auth_config_getвнешний мир

Получает конфигурацию аутентификации по идентификатору (/v3/authconfigs/{id})

Параметры

idstringобязательный
Auth config id (e.g. github, local)

rancher_auth_config_listвнешний мир

Выводит список конфигураций аутентификации (/v3/authconfigs)

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_catalog_getвнешний мир

Получает каталог по идентификатору (/v3/catalogs/{id})

Параметры

idstringобязательный
Catalog id

rancher_catalog_listвнешний мир

Перечисляет устаревшие каталоги (Norman /v3/catalogs). При любой неуспешной попытке (включая ошибки передачи) возвращает JSON с `_source unavailable` вместо жёсткой ошибки инструмента.

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_cloud_credential_getвнешний мир

Получает облачные учётные данные по идентификатору.

Параметры

idstringобязательный
Credential id

rancher_cloud_credential_listвнешний мир

Перечисляет облачные учётные данные (/v3/cloudcredentials). Секреты скрываются, если не указан show-sensitive-data.

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_cluster_getвнешний мир

Получает подробную информацию для одного кластера Rancher (здоровье, версия, количество узлов)

Параметры

formatstring
Output format: json, table (default: json)
namestringобязательный
Cluster name or ID

rancher_cluster_listвнешний мир

Выведи список всех кластеров Rancher с здоровьем, версией K8s, провайдером и количеством узлов.

Параметры

continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)

rancher_cluster_registration_token_getвнешний мир

Получает токен регистрации кластера по идентификатору.

Параметры

idstringобязательный
Token resource id

rancher_cluster_registration_token_listвнешний мир

Перечисляет токены регистрации кластера (/v3/clusterregistrationtokens). Необязательный параметр cluster_id фильтрует по кластеру.

Параметры

cluster_idstring
Filter by cluster id (query param clusterId)
limitnumber
Page size
markerstring
Pagination marker

rancher_cluster_repo_getвнешний мир

Получает репозиторий кластера по идентификатору. Сначала пытается выполнить запрос к Norman /v3/clusterrepos/{id}; при 404 читает catalog.cattle.io/v1 ClusterRepo из локального кластера. Используйте идентификатор в формате "namespace/name" или просто "name" (по умолчанию пространство имён cattle-global-data).

Параметры

idstringобязательный
Norman id or Kubernetes name; use namespace/name for fallback if not default

rancher_cluster_repo_listвнешний мир

Получает список каталогов приложений из репозиториев кластера. Сначала пробует Norman /v3/clusterrepos. При ошибке или неуспехе перечисляет catalog.cattle.io/v1 ClusterRepo в локальном экземпляре через Steve/Kubernetes, перебирая пространства имен cattle-global-data, fleet-default, fleet-local, cattle-fleet-system. Возвращает либо _source kubernetes_api_fallback с данными, либо _source unavailable с attempt_errors (без жесткой ошибки инструмента). Маркер пагинации применяется только к первому успешному пространству имен (обычно cattle-global-data).

Параметры

limitnumber
Page size
markerstring
Pagination: Norman marker, or Kubernetes continue token when using the Steve/K8s fallback

rancher_feature_flag_getвнешний мир

Получает флаг функции по идентификатору (/v3/features/{id})

Параметры

idstringобязательный
Feature id

rancher_feature_flag_listвнешний мир

Выводит список флагов функций (/v3/features)

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_global_role_binding_getвнешний мир

Получает глобальную привязку роли по идентификатору (/v3/globalrolebindings/{id})

Параметры

idstringобязательный
Binding id

rancher_global_role_binding_listвнешний мир

Перечисляет глобальные привязки ролей (/v3/globalrolebindings)

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_node_driver_listвнешний мир

Перечисляет драйверы узлов (/v3/nodedrivers)

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_norman_schema_getвнешний мир

Получает одну схему Norman по идентификатору (например, user, token, cluster) из /v3/schemas/{id}

Параметры

schema_idstringобязательный
Schema id from rancher_norman_schema_list

rancher_norman_schema_listвнешний мир

Перечисляет схемы API Norman /v3 (обнаруживает типы, ссылки на коллекции и действия для этого Rancher).

Параметры

limitnumber
Page size (optional; depends on Rancher version)
markerstring
Pagination marker from a previous response

rancher_overviewвнешний мир

Межкластерная сводка: общее количество кластеров и общее количество проектов

Параметры

formatstring
Output format: json, table (default: json)

rancher_project_listвнешний мир

Перечисляет проекты Rancher во всех кластерах

Параметры

continuestring
Pagination token from previous response (for next page)
formatstring
Output format: json, table (default: json)
limitnumber
Max items (default: 100)

rancher_setting_getвнешний мир

Получает настройку по id (/v3/settings/{id})

Параметры

idstringобязательный
Setting id (e.g. server-url)

rancher_setting_listвнешний мир

Перечисляет глобальные настройки Rancher (/v3/settings)

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_token_getвнешний мир

Получает токен Norman по идентификатору (/v3/tokens/{id}). Значение токена скрывается, если не включен show-sensitive-data.

Параметры

idstringобязательный
Token id

rancher_token_listвнешний мир

Выводит список токенов Norman API (/v3/tokens). Значения чувствительных токенов скрыты, если не включён параметр show-sensitive-data.

Параметры

limitnumber
Page size
markerstring
Pagination marker

rancher_user_getвнешний мир

Получает пользователя по идентификатору (/v3/users/{id})

Параметры

idstringобязательный
User id

rancher_user_listвнешний мир

Выводит список пользователей Rancher (/v3/users)

Параметры

limitnumber
Page size
markerstring
Pagination marker

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "rancher-mcp-server",
    "--rancher-server-url",
    "https://rancher.example.com",
    "--rancher-token",
    "token-xxxxx:yyyy",
    "--toolsets",
    "harvester,rancher,kubernetes,fleet"
  ]
}

Также mrostamii/rancher-mcp-server можно установить в Cursor по ссылке автоматически.

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт AI-агентам прямой доступ к управлению Rancher-экосистемой: Kubernetes кластеры, виртуальные машины Harvester, Helm-релизы, Fleet GitOps и все API Rancher. Вместо того чтобы переключаться между интерфейсами и вводить команды вручную, нейросеть может сама выполнять рутинные операции — от просмотра логов до обновления релизов и управления кластерами. Сервер работает через MCP-протокол, поэтому AI легко подключается к Rancher и делает то, что обычно требует CLI или UI.

Что он умеет?

Читает и описывает виртуальные машины, образы, тома, сети, хосты, аддоны, настройки, подсети и VPC в Harvester; получает детали кластеров, проектов, пользователей, токенов, auth configs, глобальных ролей, cloud credentials, каталогов, репозиториев, feature flags, настроек, аудит-логов, registration tokens, node drivers в Rancher через Norman и Steve; читает любые Kubernetes-ресурсы (get, list, describe), события, логи, общую ёмкость; листит Fleet GitRepo, Bundle, кластеры и обнаруживает дрейф.

Информация о сервере

Номер в рейтинге: #184
Звезд на Github: 12
Форков на Github: 1
Язык реализации: Go
Лицензия: Apache-2.0
Официальный сервер: Нет
Дата обновления данных: 19.07 в 09:22
Идентификатор: -tCuRrb5SEY8udd6
Категории: CI/CD и DevOps, Агенты для программирования, Архитектура ПО, Виртуализация, Инструменты для разработчиков, Облачные платформы, Сети и инфраструктура

Другие проверенные MCP-сервера

ArcadeData/arcadedb

официальный

ArcadeDB - высокопроизводительная многомодельная СУБД с поддержкой Neo4j Cypher, MongoDB, Redis и встроенным MCP-сервером для AI-ассистентов. Сочетает графы, документы и временные ряды в единой тра...

callstackincubator/agent-device

agent-device — CLI для автоматизации устройств, позволяющий AI-агентам открывать приложения на iOS, Android и десктопе, инспектировать UI, взаимодействовать с элементами и собирать отладочную инфор...

graphlit-mcp-server

официальный

MCP сервер для Graphlit — превращает проект в RAG-базу знаний из данных Slack, Discord, Jira, GitHub, Google Drive. Работает в Cursor, Windsurf, Goose, Cline. Встроен веб-краулинг и веб-поиск.

vectorize-io/hindsight

официальный

MCP сервер Hindsight наделяет AI-агентов долговременной памятью — они учатся на опыте, а не просто запоминают диалоги. Использует биомиметические структуры данных для извлечения фактов и ментальных моделей, превосходя по точности RAG и графы знаний. Подходит для персонализации чат-ботов и создани...

InfluxData/influxdb3_mcp_server

официальный

MCP сервер для InfluxDB 3: SQL-запросы, запись line protocol, управление базами и токенами. Более 20 инструментов для Core, Enterprise, Cloud. Незаменим для инженеров данных и DevOps, работающих с ...

anaisbetts/mcp-installer

MCP сервер, который автоматически устанавливает другие MCP серверы из npm и PyPi по запросу. Помогает разработчикам и пользователям Claude быстро добавлять нужные инструменты через простые команды. Требует npx и uv.