Exoscale MCP Server

AIアシスタントがExoscaleのクラウドインフラストラクチャを管理できるようにするMCP（Model Context Protocol）サーバーです。stdioとStreamable HTTPの両方のトランスポートをサポートし、安全性のためデフォルトで読み取り専用モードが有効になっています。

機能

• 10個の複合ツール — Compute、SKS（Kubernetes）、DNS、DBaaS、Block Storage、Object Storageをカバー

• 4つの読み取り専用リソース — 参照データ用（ゾーン、インスタンスタイプ、テンプレート、データベースプラン）

• デュアルトランスポート — ローカル使用（Claude Desktop、Kiro）向けのstdioと、リモート/共有デプロイメント向けのHTTP

• デフォルトで読み取り専用 — 書き込み操作にはEXOSCALE_MCP_READ_ONLY=falseによる明示的なオプトインが必要

• ドライランサポート — 実行前に任意の変更をプレビュー

• 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]セクション）

安全モデル

このサーバーは3層の安全性を実装しています：

1. 読み取り専用モード（デフォルトON） — すべての変更操作は、EXOSCALE_MCP_READ_ONLY=falseを設定するようユーザーに促す明確なエラーメッセージを返します

2. ドライランモード — 変更を伴う任意のアクションに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を参照してください。