openstack-mcp

Un servidor MCP que permite a un asistente de IA inspeccionar y operar una nube OpenStack — listar instancias, comprobar cuotas, leer el registro de consola de una VM atascada y (si se lo permites) crear y eliminar servidores.

Funciona con cualquier despliegue de OpenStack: CloudPe, OVHcloud, Infomaniak, nubes universitarias y de investigación, o un DevStack local. Cualquier cosa a la que openstacksdk pueda llegar, esto puede manejarla.

Solo lectura por defecto. Las escrituras requieren una aceptación explícita, y las eliminaciones requieren una segunda. Un asistente que puede listar tu proyecto no puede destruirlo a menos que decidas que debería poder hacerlo.

Inicio rápido

Instalar desde el código fuente (aún no en PyPI):

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

Apúntalo a una nube. openstacksdk lee la configuración estándar de OpenStack, así que o bien un 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

...o las variables de entorno habituales (OS_AUTH_URL, OS_APPLICATION_CREDENTIAL_ID, OS_APPLICATION_CREDENTIAL_SECRET). Este servidor nunca almacena ni transmite tus credenciales por sí mismo — se las entrega a openstacksdk, que las resuelve de la misma manera que hace la CLI de openstack.

Claude Code

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

Claude Desktop / Cursor / cualquier cliente MCP

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

Luego pregunta cosas como "¿qué VMs están caídas?", "¿tengo cuota para tres m1.large más?" o "web-03 no acepta SSH — revisa su registro de consola."

Para confirmar lo que has conectado antes de confiar en ello, ejecuta una comprobación en seco — imprime la configuración resuelta y exactamente qué herramientas están expuestas, sin servir ni conectar:

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

El modelo de seguridad

La mayoría de los servidores MCP de nube entregan al asistente la API completa y esperan lo mejor. Este está restringido, porque "elimina las VMs de prueba" es una frase que un modelo puede malinterpretar.

Dos salvaguardas adicionales:

• **delete_server exige confirmación. Debes pasar confirm_name que coincida exactamente el nombre exacto de la instancia resuelta. Pídele que elimine web-1 cuando la VM se llama web-01 y se niega en lugar de adivinar.

• **Las herramientas llevan anotaciones MCP (read_only_hint, `destructivo_hint), para que los clientes que muestran el riesgo al usuario antes de ejecutar una herramienta pueden hacerlo correctamente.

La restricción de herramientas se aplica en el registro, no pidiendo amablemente al modelo — verificado en una sesión real de stdio en la suite de pruebas.

Herramientas

**Lectura (siempre disponible)

**Escritura (opt-in)

Dos decisiones de diseño que vale la pena conocer

**Las respuestas son deliberadamente pequeñas. openstacksdk devuelve más de 60 atributos por servidor. Alimentar todo eso a un modelo es lento, costoso y entierra los campos útiles, así que cada herramienta devuelve una proyección recortada — para un servido que es id, nombre, estado y un mapa {red: [ips] en lugar de la estructura de direcciones anidada de nova.

**check_capacidad existe para que los lotes falla temprano. Pedir ocho VMs y descubrir el límite de cuota en el quinto deja un desastre a medio construir. Esto informa cuál de instancias/vCPUs/RAM se agota primero, antes de crear nada. create_servers también informa fallos parciales por instancia en lugar de descartar lo que tuvo éxito.

Desarrollo

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 .

La suite se ejecuta completamente sin conexión contra una conexión falsa de `openstacksdk — sin nube, sin credenciales, sin cargos. Cubre la restricción de herramientas, el recorte, la aritmética de cuota, el informe de fallos parciales y la confirmación de eliminación.

Aprovisionamiento a escala

Para levantar flotas de forma declarativa en lugar de conversacional, consulta [cloudpe-terraform-bulk-vm](https://github.com/abhisambad-leapswitch/cloudpe-terraform-bulk-vm — Terraform para la creación de VMs en la misma API.

Licencia

MIT