Exoscale MCP Server

Ein MCP-Server (Model Context Protocol), der KI-Assistenten die Verwaltung der Exoscale-Cloud-Infrastruktur ermöglicht. Unterstützt sowohl stdio- als auch Streamable-HTTP-Transporte, wobei der Read-only-Modus aus Sicherheitsgründen standardmäßig aktiviert ist.

Funktionen

• 10 zusammengesetzte Tools für Compute, SKS (Kubernetes), DNS, DBaaS, Block Storage und Object Storage

• 4 Read-only-Ressourcen für Referenzdaten (Zonen, Instanztypen, Vorlagen, Datenbankpläne)

• Dualer Transport — stdio für die lokale Nutzung (Claude Desktop, Kiro) und HTTP für Remote-/gemeinsame Bereitstellungen

• Standardmäßig schreibgeschützt — Schreiboperationen erfordern ein explizites Opt-in über EXOSCALE_MCP_READ_ONLY=false

• Dry-run-Unterstützung — Vorschau jeder Änderung vor der Ausführung

• EXO2-HMAC-SHA256-Authentifizierung mit Auflösung der Anmeldedaten über Umgebungsvariablen und Konfigurationsdatei

Related MCP server: TianGong-AI-MCP

Schnellstart

# 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

Konfiguration

Die CLI-Flags --http und --port <n> überschreiben die Umgebungsvariablen.

Auflösung der Anmeldedaten

1. Umgebungsvariablen EXOSCALE_API_KEY + EXOSCALE_API_SECRET

2. Datei ~/.exoscale/config (INI-Format, Abschnitt [default])

Sicherheitsmodell

Der Server implementiert drei Sicherheitsebenen:

1. Read-only-Modus (standardmäßig aktiviert) — Alle Schreiboperationen geben eine klare Fehlermeldung zurück, die den Benutzer anweist, EXOSCALE_MCP_READ_ONLY=false zu setzen

2. Dry-run-Modus — Übergeben Sie dryRun: true an eine beliebige Schreiboperation, um eine Vorschau des Ergebnisses zu erhalten

3. Destruktive Annotationen — Tools sind mit destructiveHint: true annotiert, damit MCP-Clients eine Bestätigung anfordern können

Tools

Ressourcen

MCP-Client-Konfiguration

Kiro / Claude Desktop (stdio)

Fügen Sie Folgendes zu Ihrer MCP-Konfiguration hinzu:

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

HTTP-Modus

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

Verbinden Sie dann Ihren MCP-Client mit http://127.0.0.1:3000/mcp.

Entwicklung

# 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

Architektur

Eine detaillierte Systemübersicht finden Sie in ARCHITECTURE.md.

Mitwirken

Richtlinien zum Hinzufügen von Tools, Ressourcen und Tests finden Sie in CONTRIBUTING.md.

Lizenz

Apache License 2.0 — Einzelheiten finden Sie in LICENSE.