openstack-mcp

Сервер MCP, который позволяет ИИ-ассистенту просматривать и управлять облаком OpenStack — выводить список инстансов, проверять квоты, читать журнал консоли зависшей ВМ и (если вы разрешите) создавать и удалять серверы.

Работает с любым развёртыванием OpenStack: CloudPe, OVHcloud, Infomaniak, университетские и исследовательские облака или локальный DevStack. Всё, до чего может дотянуться openstacksdk, этим можно управлять.

По умолчанию только чтение. Запись требует явного согласия, а удаление — второго. Ассистент, который может просматривать ваш проект, не сможет его разрушить, если вы этого не разрешили.

Быстрый старт

Установка из исходников (пока нет на PyPI):

pipx install git+https://github.com/abhishekambad-leapswitch/openstack-mcp

Укажите облако. openstacksdk читает стандартную конфигурацию OpenStack, так что либо clouds.yaml:

# ~/.config/openstack/clouds.yaml
clouds:
  cloudpe:
    auth_type: v3applicationcredential
    auth:
      auth_url: https://<your-region>.cloudpe.com:5000/v3
      application_credential_id: <id>
      application_credential_secret: <secret>
    region_name: RegionOne

...или обычные переменные окружения (OS_AUTH_URL, OS_APPLICATION_CREDENTIAL_ID, OS_APPLICATION_CREDENTIAL_SECRET). Этот сервер сам никогда не хранит и не передаёт ваши учётные данные — он передаёт управление openstacksdk, который разрешает их так же, как это делает CLI openstack.

Claude Code

claude mcp add openstack --env OS_CLOUD=cloudpe -- openstack-mcp

Claude Desktop / Cursor / любой MCP-клиент

{
  "mcpServers": {
    "openstack": {
      "command": "openstack-mcp",
      "env": { "OS_CLOUD": "cloudpe" }
    }
  }
}

Затем спрашивайте что-то вроде «какие ВМ остановлены?», «есть ли у меня квота ещё на три m1.large?» или «web-03 не принимает SSH — проверь его журнал консоли».

Чтобы убедиться в правильности настройки перед доверием, выполните сухую проверку — она выводит разрешённую конфигурацию и точный список доступных инструментов, ничего не запуская и не подключаясь:

openstack-mcp --check

openstack-mcp 0.1.0
cloud: cloudpe
mode: read-only
max items per list: 50
12 tools: check_capacity, cloud_info, get_console_output, get_quotas, get_server,
list_flavors, list_images, list_keypairs, list_networks, list_security_groups,
list_servers, list_volumes

Модель безопасности

Большинство облачных MCP-серверов отдают ассистенту полный API и надеются на лучшее. Этот — с ограничениями, потому что «удали тестовые ВМ» — это фраза, которую модель может понять неправильно.

Ещё два предохранителя:

• delete_server требует подтверждения. Вы должны передать confirm_name, точно совпадающий с именем найденного инстанса. Попросите удалить web-1, когда ВМ называется web-01, и он откажется, а не будет угадывать.

• Инструменты несут MCP-аннотации (read_only_hint, destructive_hint), чтобы клиенты, показывающие пользователю риск перед запуском инструмента, могли делать это корректно.

Ограничение инструментов применяется при регистрации, а не вежливой просьбой к модели — это проверено на реальной stdio-сессии в тестовом наборе.

Инструменты

Чтение (доступно всегда)

Запись (по согласию)

Два конструктивных решения, о которых стоит знать

Ответы намеренно небольшие. openstacksdk возвращает более 60 атрибутов на сервер. Передавать их все модели медленно, дорого и скрывает полезные поля, поэтому каждый инструмент возвращает усечённую проекцию — для сервера это id, имя, статус и плоская карта {сеть: [IP-адреса]} вместо вложенной структуры адресов nova.

check_capacity существует, чтобы пакетные операции завершались на раннем этапе. Запрос восьми ВМ и обнаружение потолка квоты на пятой оставляет полуразрушенный беспорядок. Этот инструмент сообщает, что именно ограничивает — инстансы, vCPU или ОЗУ, — до создания чего-либо. create_servers также сообщает о частичных сбоях по каждому инстансу, а не отбрасывает то, что удалось.

Разработка

git clone https://github.com/abhishekambad-leapswitch/openstack-mcp
cd openstack-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest && ruff check .

Набор тестов полностью работает офлайн с фейковым подключением openstacksdk — без облака, учётных данных и расходов. Он покрывает ограничение инструментов, усечение, арифметику квот, отчёты о частичных сбоях и подтверждение удаления.

Масштабное развёртывание

Для декларативного развёртывания парков машин, а не в диалоговом режиме, см. cloudpe-terraform-bulk-vm — Terraform для массового создания ВМ через тот же API.

Лицензия

MIT