infrabroker — MCP-сервер для Claude Code: SSH и Kubernetes без ключей
Брокер доступа к инфраструктуре: агент просит выполнить команду, а сертификат и токен живут в памяти брокера и в контекст модели не попадают.
claude mcp add infrabroker -- docker run -i --rm ghcr.io/luisgf/infrabroker:3.1.3Что делает infrabroker
Агент отправляет действие — запустить команду на хосте, прочитать или изменить состояние кластера. infrabroker сверяет его с политикой, выполняет с одноразовым SSH-сертификатом от собственного CA или короткоживущим привязанным токеном ServiceAccount и возвращает только вывод. Ключи и токены стираются после вызова, поэтому угнать через промпт-инъекцию нечего.
Один бинарник infrabroker отдаёт один и тот же движок через три транспорта, выбор — подкомандой. Для локальной работы есть infrabroker serve-mcp (stdio, без транспортной аутентификации), для нескольких пользователей — infrabroker serve-mcp-http с проверкой OIDC-токена по JWKS издателя, для сетевых агентов — infrabroker serve-http с mTLS. Инструменты: ssh_execute, ssh_session_open и парные к ней, ssh_list_servers, ssh_put_file и ssh_get_file; при настроенных кластерах добавляются k8s_get, k8s_list, k8s_logs, k8s_apply, k8s_delete и k8s_list_clusters.
Права на sudo задаются в подписывающей стороне через allow_sudo и allowed_sudo_users — скомпрометированный брокер не поднимет привилегии там, где политика это запрещает. CA-ключи можно держать в Azure Key Vault или в ssh-agent с YubiKey PIV, SoftHSM или TPM, тогда приватный ключ не покидает модуль. Каждый сертификат ограничен временем жизни в минуты, адресом источника и, для одноразового вызова, обязательной командой: вне своего хоста и окна он бесполезен.
Какие задачи решает
- выполнить команду на удалённом хосте, не отдавая агенту приватный ключ
- прочитать логи пода в кластере без kubeconfig
- запретить агенту опасные команды через политику allow/deny
- поднять привилегии только там, где разрешено политикой
- разобрать, кто и что запускал, по цепочке аудита
Примеры запросов агенту
- Выполни
uptimeна хосте web-01 через infrabroker - Покажи логи пода
api-7d9fв кластере prod - Скопируй
deploy.shна хост build-02
Как установить infrabroker
Командой платформы
claude mcp add infrabroker -- docker run -i --rm ghcr.io/luisgf/infrabroker:3.1.3Командой платформы
codex mcp add infrabroker -- docker run -i --rm ghcr.io/luisgf/infrabroker:3.1.3Файл настроек
{
"mcpServers": {
"infrabroker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/luisgf/infrabroker:3.1.3"
]
}
}
}Файл настроек
{
"servers": {
"infrabroker": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/luisgf/infrabroker:3.1.3"
]
}
}
}Командой платформы
gemini mcp add infrabroker docker run -i --rm ghcr.io/luisgf/infrabroker:3.1.3По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о infrabroker
Как установить infrabroker в Claude Code?
Одной командой: claude mcp add infrabroker -- docker run -i --rm ghcr.io/luisgf/infrabroker:3.1.3. Она регистрирует MCP-сервер, который запускается в контейнере.
Что делает infrabroker?
Выступает посредником между агентом и инфраструктурой. Агент просит действие, брокер проверяет его по политике, выполняет с одноразовым сертификатом или токеном и отдаёт обратно только вывод команды.
Попадут ли ключи в контекст модели?
Нет. Сертификаты и токены создаются под одну операцию и хранятся в памяти брокера, а после вызова удаляются.
