Exoscale MCP Server

Un servidor MCP (Model Context Protocol) que permite a los asistentes de IA gestionar la infraestructura en la nube de Exoscale. Soporta transportes stdio y Streamable HTTP, con el modo de solo lectura activado por defecto por seguridad.

Características

• 10 herramientas compuestas que cubren Compute, SKS (Kubernetes), DNS, DBaaS, Block Storage y Object Storage

• 4 recursos de solo lectura para datos de referencia (zonas, tipos de instancia, plantillas, planes de base de datos)

• Transporte dual — stdio para uso local (Claude Desktop, Kiro) y HTTP para despliegues remotos/compartidos

• Solo lectura por defecto — las operaciones de escritura requieren un opt-in explícito mediante EXOSCALE_MCP_READ_ONLY=false

• Compatibilidad con dry-run — previsualiza cualquier mutación antes de ejecutarla

• Autenticación EXO2-HMAC-SHA256 con resolución de credenciales mediante variables de entorno y archivo de configuración

Related MCP server: TianGong-AI-MCP

Inicio rápido

# Install dependencies
npm install

# Build
npm run build

# Run in stdio mode (default, read-only)
EXOSCALE_API_KEY=your-key EXOSCALE_API_SECRET=your-secret npm start

# Run in HTTP mode
npm run start:http

Configuración

Las opciones de CLI --http y --port <n> anulan las variables de entorno.

Resolución de credenciales

1. Las variables de entorno EXOSCALE_API_KEY + EXOSCALE_API_SECRET

2. El archivo ~/.exoscale/config (formato INI, sección [default])

Modelo de seguridad

El servidor implementa tres capas de seguridad:

1. Modo de solo lectura (activado por defecto) — Todas las mutaciones devuelven un mensaje de error claro que indica al usuario que establezca EXOSCALE_MCP_READ_ONLY=false

2. Modo dry-run — Pasa dryRun: true a cualquier acción de mutación para previsualizar lo que sucedería

3. Anotaciones destructivas — Las herramientas están anotadas con destructiveHint: true para que los clientes MCP puedan solicitar confirmación

Herramientas

Recursos

Configuración del cliente MCP

Kiro / Claude Desktop (stdio)

Añade lo siguiente a tu configuración de MCP:

{
  "mcpServers": {
    "exoscale": {
      "command": "node",
      "args": ["/path/to/exoscale-mcp/dist/index.js"],
      "env": {
        "EXOSCALE_API_KEY": "your-key",
        "EXOSCALE_API_SECRET": "your-secret"
      }
    }
  }
}

Modo HTTP

EXOSCALE_API_KEY=key EXOSCALE_API_SECRET=secret node dist/index.js --http --port 3000

Luego conecta tu cliente MCP a http://127.0.0.1:3000/mcp.

Desarrollo

# Dev mode (tsx, auto-restarts not included)
npm run dev

# Type check
npm run lint

# Run tests
npm test

# Run with coverage
npm run test:coverage

# Regenerate types from OpenAPI spec
npm run generate:types

Arquitectura

Consulta ARCHITECTURE.md para obtener una visión general detallada del sistema.

Contribuciones

Consulta CONTRIBUTING.md para conocer las pautas sobre cómo añadir herramientas, recursos y pruebas.

Licencia

Apache License 2.0 — consulta LICENSE para obtener más detalles.