Exoscale MCP Server

MCP-сервер (Model Context Protocol), который позволяет ИИ-ассистентам управлять облачной инфраструктурой Exoscale. Поддерживает оба транспорта — stdio и Streamable HTTP — с включённым по умолчанию режимом только для чтения для безопасности.

Возможности

• 10 составных инструментов для Compute, SKS (Kubernetes), DNS, DBaaS, Block Storage и Object Storage

• 4 ресурса только для чтения со справочными данными (зоны, типы инстансов, шаблоны, тарифы баз данных)

• Два транспорта — stdio для локального использования (Claude Desktop, Kiro) и HTTP для удалённых/общих развёртываний

• Только чтение по умолчанию — операции записи требуют явного включения через EXOSCALE_MCP_READ_ONLY=false

• Поддержка dry-run — предварительный просмотр любых изменений перед выполнением

• Аутентификация EXO2-HMAC-SHA256 с определением учётных данных через переменные окружения и файл конфигурации

Related MCP server: TianGong-AI-MCP

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

# 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

Конфигурация

Флаги CLI --http и --port <n> переопределяют переменные окружения.

Определение учётных данных

1. переменные окружения EXOSCALE_API_KEY + EXOSCALE_API_SECRET

2. файл ~/.exoscale/config (формат INI, секция [default])

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

Сервер реализует три уровня безопасности:

1. Режим только для чтения (включён по умолчанию) — Все изменяющие операции возвращают понятное сообщение об ошибке, предлагающее пользователю установить EXOSCALE_MCP_READ_ONLY=false

2. Режим dry-run — Передайте dryRun: true в любое изменяющее действие, чтобы предварительно просмотреть, что произойдёт

3. Аннотации деструктивных операций — Инструменты аннотированы с destructiveHint: true, чтобы MCP-клиенты могли запрашивать подтверждение

Инструменты

Ресурсы

Конфигурация MCP-клиента

Kiro / Claude Desktop (stdio)

Добавьте в вашу конфигурацию MCP:

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

HTTP-режим

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

Затем подключите ваш MCP-клиент к http://127.0.0.1:3000/mcp.

Разработка

# 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

Архитектура

Подробный обзор системы см. в ARCHITECTURE.md.

Участие в разработке

Рекомендации по добавлению инструментов, ресурсов и тестов см. в CONTRIBUTING.md.

Лицензия

Apache License 2.0 — подробности см. в LICENSE.