ocm-mcp-server — MCP-сервер для Claude Code
Даёт агенту доступ к нескольким кластерам Kubernetes через хаб Open Cluster Management. Чтение свободное, записи проходят проверку политикой и одобрение человека.
claude mcp add --env KUBECONFIG=<KUBECONFIG> --env OCM_MCP_HUB_CONTEXT=<OCM_MCP_HUB_CONTEXT> --env OCM_MCP_READ_ONLY=<OCM_MCP_READ_ONLY> --transport stdio ocm-mcp-server -- uvx ocm-mcp-serverЧто делает ocm-mcp-server
Сервер ставит между моделью и кластерами прослойку: агент обращается к хабу Open Cluster Management, своих учётных данных у него нет. Запросы на изменение проверяются политикой Kyverno, требуют подписи человека и пишутся в журнал аудита. Так модель может разобрать инцидент и предложить правку, не получая прав на удаление чего угодно.
Для запуска нужен Python 3.11+ и установленный пакет ocm-mcp-server — можно через pip, а можно сразу uvx. Через переменные окружения передаются KUBECONFIG, контекст хаба OCM_MCP_HUB_CONTEXT и флаг OCM_MCP_READ_ONLY. Последний стоит включить, если агенту пока хватает диагностики: тогда записи отсекаются на входе, а не после проверки.
Имя хаба задаётся контекстом в kubeconfig — без него сервер не поймёт, к какому кластеру OCM обращаться. И вся схема держится на настроенной политике: если в хабе нет нужных правил, проверка записей превратится в формальность.
Какие задачи решает
- разобрать деградацию нагрузки сразу в нескольких кластерах
- предложить правку через ManifestWork и дождаться одобрения
- посмотреть состояние флота, не выдавая модели kubeconfig
- записать ход инцидента по журналу аудита
- проверить запись агента политикой Kyverno до применения
Примеры запросов агенту
- Покажи, какие нагрузки деградируют в кластерах флота, и предложи исправление
- Подготовь ManifestWork с правкой лимитов и дождись моего токена на применение
- Включи режим только для чтения и собери отчёт о состоянии хаба
Как установить ocm-mcp-server
Командой платформы
claude mcp add --env KUBECONFIG=<KUBECONFIG> --env OCM_MCP_HUB_CONTEXT=<OCM_MCP_HUB_CONTEXT> --env OCM_MCP_READ_ONLY=<OCM_MCP_READ_ONLY> --transport stdio ocm-mcp-server -- uvx ocm-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ocm-mcp-server <команда>
Командой платформы
codex mcp add ocm-mcp-server --env KUBECONFIG=<KUBECONFIG> --env OCM_MCP_HUB_CONTEXT=<OCM_MCP_HUB_CONTEXT> --env OCM_MCP_READ_ONLY=<OCM_MCP_READ_ONLY> -- uvx ocm-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ocm-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"ocm-mcp-server": {
"command": "uvx",
"args": [
"ocm-mcp-server"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"OCM_MCP_HUB_CONTEXT": "<OCM_MCP_HUB_CONTEXT>",
"OCM_MCP_READ_ONLY": "<OCM_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ocm-mcp-server <команда>
Файл настроек
{
"servers": {
"ocm-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"ocm-mcp-server"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"OCM_MCP_HUB_CONTEXT": "<OCM_MCP_HUB_CONTEXT>",
"OCM_MCP_READ_ONLY": "<OCM_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ocm-mcp-server <команда>
Командой платформы
gemini mcp add -e KUBECONFIG=<KUBECONFIG> -e OCM_MCP_HUB_CONTEXT=<OCM_MCP_HUB_CONTEXT> -e OCM_MCP_READ_ONLY=<OCM_MCP_READ_ONLY> ocm-mcp-server uvx ocm-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ocm-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ocm-mcp-server
Как установить ocm-mcp-server в Claude Code?
Выполните claude mcp add ocm-mcp-server -e KUBECONFIG=<KUBECONFIG> -- uvx ocm-mcp-server. Если нужны контекст хаба и режим только для чтения, есть второй вариант: `claude mcp add --env KUBECONFIG=<KUBECONFIG> --env OCM_MCP_HUB_CONTEXT=<OCM_MCP_HUB_CONTEXT> --env OCM_MCP_READ_ONLY=<OCM_MCP_READ_ONLY> --transport stdio ocm-mcp-server -- uvx ocm-mcp-server`.
Что делает ocm-mcp-server?
Превращает хаб Open Cluster Management в инструмент для агента: чтение состояния кластеров, подготовка изменений, проверка политикой и ожидание одобрения человека перед записью.
Какие переменные окружения нужны?
KUBECONFIG с доступом к хабу, OCM_MCP_HUB_CONTEXT с именем контекста хаба и OCM_MCP_READ_ONLY для режима без записи.
