Crossplane — MCP-сервер для Claude Code: что делает и как установить
Сервер связывает ИИ-ассистента с control plane Crossplane для проверки ресурсов, пакетов и композиций. Пригодится при отладке упавших клеймов и поиске причин сбоев в инфраструктуре.
claude mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5Что делает Crossplane
Ассистент опрашивает Crossplane напрямую через Kubernetes API, ориентируясь на категории ресурсов: managed, composite и claim. Сервер строит дерево зависимостей по resourceRefs, аналогично команде crossplane beta trace. Инструмент crossplane_diagnose находит глубокую причину ошибки вместо верхнеуровневого симптома, а crossplane_drift_detect сравнивает фактическое состояние с желаемым.
По умолчанию сервер работает строго в режиме чтения. Инструменты создания и обновления не регистрируются вовсе, пока не передан флаг --read-only=false. Удалять ресурсы он не умеет ни при каких настройках, поэтому случайный снос рабочей базы данных через промпт исключён. Поддерживаются структуры версий Crossplane v1 и v2.
Для проверки гипотез есть инструмент crossplane_composition_render, который прогоняет пайплайн функций офлайн без изменения кластера. Если удаление ресурса зависло, crossplane_deleting_resources покажет блокирующий финализатор или провайдер.
Какие задачи решает
- найти первопричину ошибки в неготовом клейме через
crossplane_diagnose - отследить дрейф параметров инфраструктуры с помощью
crossplane_drift_detect - выяснить причину зависания при удалении ресурса
- смоделировать рендеринг композиции без отправки манифестов в кластер
Примеры запросов агенту
- Проверь, почему клейм базы данных orders-db находится в состоянии NotReady
- Покажи дерево ресурсов для CompositePostgreSQLInstance и найди сбойный компонент
- Оцени последствия удаления композиции перед внесением правок
Как установить Crossplane
Командой платформы
claude mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5Командой платформы
codex mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5Файл настроек
{
"mcpServers": {
"crossplane": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5"
]
}
}
}Файл настроек
{
"servers": {
"crossplane": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5"
]
}
}
}Командой платформы
gemini mcp add crossplane docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Crossplane
Как установить Crossplane в Claude Code?
Выполните команду claude mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5. Для запуска нужен работающий Docker.
Что делает MCP-сервер Crossplane?
Он передаёт языковой модели данные о состоянии control plane Crossplane, разбирая связи ресурсов, статус пакетов и ошибки синхронизации. Ассистент получает контекст реального кластера и точные причины неполадок.
Может ли ассистент случайно удалить инфраструктуру?
Нет, операции удаления отключены на уровне архитектуры сервера даже при передаче флага --read-only=false.
