sacloud/sacloud-mcp

Übersicht

sacloud/sacloud-mcp ist ein MCP-Server für die Sakura Cloud.

Aufbau der Entwicklungsumgebung

Erforderliche Tools

Klonen des Projekts

git clone https://github.com/sacloud/sacloud-mcp.git

Installation von uv

Für detailliertere Informationen zur Installation und Verwendung siehe die Dokumentation von uv.

curl -LsSf https://astral.sh/uv/install.sh | sh

Synchronisierung der Umgebung

uv sync

Installation des MCP im LLM

Installieren Sie das MCP in einem LLM Ihrer Wahl. Als Beispiel wird hier die Konfiguration für den Claude Desktop gezeigt.

Fügen Sie dem Konfigurationsfile des Claude Desktops Folgendes hinzu. Der Speicherort der Konfigurationsdatei ist je nach Betriebssystem wie folgt:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%Claudeclaude_desktop_config.json

{
  "mcpServers": {
    "sacloud": {
      "command": "${HOME}/.local/bin/uv",
      "args": [
        "--directory",
        "<<MCPサーバーのルートディレクトリ>>/src",
        "run",
        "main.py"
      ],
      "env": {
        "<<環境変数1>>": "<<値をコピーしてここへ貼り付ける>>",
        "<<環境変数2>>": "<<値をコピーしてここへ貼り付ける>>"
      }
    }
  }
}

Ersetzen Sie die mit <<>> gekennzeichneten Elemente gemäß den folgenden Hinweisen:

• Stammverzeichnis des MCP-Servers

  • Beispiel: /Users/user/Source/sacloud-mcp

• Umgebungsvariablen

  • Legen Sie die Umgebungsvariablen entsprechend der verwendeten Funktionen fest.

    • Wenn Sie auf Ressourcen der Sakura Cloud zugreifen, beziehen Sie sich auf den API-Schlüssel der Sakura Cloud und ersetzen Sie die Werte.

      • "ACCESS_TOKEN": "<<Wert kopieren und hier einfügen>>"

      • "ACCESS_TOKEN_SECRET": "<<Wert kopieren und hier einfügen>>"

    • Wenn Sie auf den Sakura Objektspeicher zugreifen, beziehen Sie sich auf den API-Schlüssel des Sakura Objektspeichers und ersetzen Sie die Werte.

      • "OBJECTSTORAGE_ACCESS_KEY_ID": "<<Wert kopieren und hier einfügen>>"

      • "OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<Wert kopieren und hier einfügen>>"

Testen

Über die Konfiguration

In tests/conftest.py sind Fixtures definiert, die in allen Testdateien verfügbar sind und ohne expliziten import aus allen Testdateien heraus verwendet werden können.

Vorbereitung

Da die Authentifizierungsinformationen aus Umgebungsvariablen bezogen werden, müssen ACCESS_TOKEN und ACCESS_TOKEN_SECRET vor der Testausführung gesetzt werden.

export ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxx
export ACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxx

Testausführung

uv run pytest

Lizenz

sacloud-mcp Copyright (C) 2025- Die sacloud/sacloud-mcp Autoren. Dieses Projekt wird unter der Apache 2.0 Lizenz veröffentlicht.