Exoscale MCP Server

AI 어시스턴트가 Exoscale 클라우드 인프라를 관리할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. 기본적으로 안전을 위해 읽기 전용 모드가 활성화된 stdio 및 Streamable HTTP 전송을 모두 지원합니다.

Features

• 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

Quick Start

# 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

Configuration

CLI 플래그 --http 및 --port <n>은 환경 변수를 재정의합니다.

Credential Resolution

1. EXOSCALE_API_KEY + EXOSCALE_API_SECRET 환경 변수

2. ~/.exoscale/config 파일(INI 형식, [default] 섹션)

Safety Model

이 서버는 세 가지 안전 계층을 구현합니다:

1. 읽기 전용 모드(기본 ON) — 모든 변경 작업은 사용자에게 EXOSCALE_MCP_READ_ONLY=false로 설정하도록 안내하는 명확한 오류 메시지를 반환합니다.

2. 드라이런 모드 — 변경 작업에 dryRun: true를 전달하여 어떤 일이 발생할지 미리 볼 수 있습니다.

3. 파괴적 작업 주석 — 도구에 destructiveHint: true가 주석으로 표시되어 MCP 클라이언트가 확인을 요청할 수 있습니다.

Tools

Resources

MCP Client Configuration

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 mode

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

그런 다음 MCP 클라이언트를 http://127.0.0.1:3000/mcp에 연결하세요.

Development

# 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

자세한 시스템 개요는 ARCHITECTURE.md를 참조하세요.

Contributing

도구, 리소스 및 테스트 추가에 관한 지침은 CONTRIBUTING.md를 참조하세요.

License

Apache License 2.0 — 자세한 내용은 LICENSE를 참조하세요.