Steadybit MCP Server

Steadybit MCP Server

警告

非推奨です。 このスタンドアロンの MCP サーバーは、現在メンテナンスされていません。代わりに、Steadybit プラットフォームに組み込まれているホスト型の リモート MCP サーバーをご利用ください。ローカルへのインストールが不要で、OAuth に対応しており、より多くのツール（環境、ターゲット、アクション、サービス、実験の設計、提案、実行分析）を利用できます。 セットアップ手順については、ドキュメントをご覧ください。

Steadybit 用の MCP サーバーです。Claude などの LLM ツールから Steadybit プラットフォームを利用できます。

ツール

1. list-experiment-designs
   • 実験設計の一覧を取得します
   • 必須入力：
     • team（文字列）：実験設計の一覧を取得するチームキー
   • 戻り値：キーと名前を含む実験設計の一覧
2. get_experiment_design
   • 実験設計を取得します
   • 必須入力：
     • experimentKey（文字列）：取得する実験キー
   • 戻り値：実験設計
3. list_experiment_executions
   • 実験実行の一覧を取得します
   • 任意の入力：
     • experiment（文字列のリスト）：1 つ以上の実験キーで絞り込みます
     • environment（文字列のリスト）：1 つ以上の環境名で絞り込みます
     • team（文字列のリスト）：1 つ以上のチームキーで絞り込みます
     • state（文字列のリスト）：1 つ以上の結果状態で絞り込みます。指定できる値は [CREATED, PREPARED, RUNNING, FAILED, CANCELED, COMPLETED, ERRORED] です
     • from（文字列、ISO8601 日付）：作成日をこの日付以降に絞り込みます
     • to（文字列、ISO8601 日付）：作成日をこの日付以前に絞り込みます
     • page（数値）：要求するページ番号。デフォルトは 0 です
     • pageSize（数値）：1 ページあたりの結果数。デフォルトは 50 で、最大 100 です
   • 戻り値：実験設計
4. get_experiment_execution
   • 実験実行を取得します
   • 必須入力：
     • executionId（数値）：取得する実行 ID
   • 戻り値：実験実行
5. list_actions
   • 現在登録されているアクションの一覧
   • 任意の入力：
     • page（数値）：要求するページ番号。デフォルトは 0 です
     • pageSize（数値）：1 ページあたりの結果数。デフォルトは 50 で、最大 100 です
   • 戻り値：アクションの一覧
6. list_environments
   • 環境の一覧を取得します
   • 戻り値：環境の一覧
7. list_teams
   • チームの一覧を取得します
   • 戻り値：チームの一覧
8. list_experiment_schedules
   • 実験スケジュールの一覧を取得します
   • 任意の入力：
     • experiment（文字列のリスト）：1 つ以上の実験キーで絞り込みます
     • team（文字列のリスト）：1 つ以上のチームキーで絞り込みます
   • 戻り値：実験スケジュールの一覧
9. list_experiment_templates
   • 実験テンプレートの一覧（名前と ID）を取得します
10. get_experiment_template
    • 設計を含む実験テンプレートを取得します
    • 必須入力：
      • templateId（文字列）：実験の作成元となるテンプレートの ID
11. create_experiment_from_template
    • テンプレートから実験を作成します
    • たとえば環境変数 CAPABILITIES_ENABLED_0=CREATE_EXPERIMENT_FROM_TEMPLATE を設定して有効にする必要があります
    • 必須入力：
      • templateId（文字列）：実験の作成元となるテンプレートの ID
      • environment（文字列）：実験で使用する環境
      • team（文字列）：実験で使用するチーム
    • 任意の入力：
      • placeholders（オブジェクト）：プレースホルダーキーとその値のマップです。
      • externalId（文字列）：既存の実験設計の更新に使用できる任意の外部 ID です。
    • 戻り値：作成された実験のキー。実験を作成できなかった場合はエラーメッセージ

セットアップ

Steadybit アカウントと API トークンが必要です。API トークンは Steadybit プラットフォームの 設定 → API アクセストークンで作成できます。Admin と Team の両方のトークンタイプに対応しています。

実験を作成する場合は、実験を作成するチームのチームトークンが必要です。

対応している環境変数

• API_TOKEN：認証に使用する API トークンです。必須です。
• API_URL：Steadybit API の URL です。デフォルトは https://platform.steadybit.com/api です。
• CAPABILITIES_ENABLED_0、CAPABILITIES_ENABLED_1、...：有効にする追加機能です。現在、次の機能に対応しています。
  • CREATE_EXPERIMENT_FROM_TEMPLATE：create_experiment_from_template ツールを有効にします。

Claude Desktop での使用方法

Claude Desktop で 設定 → 開発者 → 編集に移動し、次の JSON を追加して、<your-api-token> を実際のトークンに置き換えます。

{
  "mcpServers": {
    "steadybit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "ghcr.io/steadybit/mcp:latest"
      ],
      "env": {
        "API_TOKEN": "<your-api-token>"
      }
    }
  }
}

ローカル開発

前提条件

• Java 21+
• Maven 3.9+
• Docker（Docker イメージのフローでのみ必要です）
• Node.js / npx（MCP インスペクターの実行に使用します）

MCP サーバーは STDIO トランスポートを使用するため、コンソールへのログ出力はありません。サーバーの出力は、サーバーを起動したディレクトリの steadybit-mcp.log に書き込まれます。

ビルド

mvn clean install

生成された jar は target/mcp-<version>-SNAPSHOT.jar にあります。

MCP インスペクターを使ったローカル実行

npx @modelcontextprotocol/inspector \
  java -jar target/mcp-1.0.0-SNAPSHOT.jar \
  -e API_URL=https://platform.steadybit.com/api \
  -e API_TOKEN=<your-api-token>

ログは、インスペクターを起動したディレクトリの steadybit-mcp.log に書き込まれます。

ローカルの jar を使用して Claude Desktop で実行

Claude Desktop の開発者設定（設定 → 開発者 → 編集）を編集し、ローカルの Java バイナリとビルドしたばかりの jar を指定します。

{
  "mcpServers": {
    "steadybit": {
      "command": "/path/to/your/java",
      "args": [
        "-jar",
        "/path/to/your/.m2/repository/com/steadybit/mcp/1.0.0-SNAPSHOT/mcp-1.0.0-SNAPSHOT.jar"
      ],
      "env": {
        "API_URL": "https://platform.steadybit.com/api",
        "API_TOKEN": "<your-api-token>",
        "LOGGING_FILE_NAME": "/path/to/Library/Logs/Claude/steadybit-mcp-server.log"
      }
    }
  }
}

• MCP クライアントのログ：~/Library/Logs/Claude/mcp-server-steadybit.log
• MCP サーバーのログ：LOGGING_FILE_NAME で設定したパス（デフォルトは、起動ファイルと同じ場所にある steadybit-mcp.log）

テストの実行

mvn test

Docker イメージのビルド

docker build -t steadybit/mcp -f Dockerfile .

次に、config.json を作成し、イメージに対してインスペクターを実行します。

{
  "mcpServers": {
    "steadybit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "-e",
        "API_URL",
        "steadybit/mcp"
      ],
      "env": {
        "API_TOKEN": "<your-api-token>",
        "API_URL": "https://platform.steadybit.com/api"
      }
    }
  }
}

npx @modelcontextprotocol/inspector --config config.json --server steadybit

ネイティブイメージのビルド

sdkman を使って GraalVM 24.0.1 をインストールします。

sdk install java 24.0.1-graalce
sdk use java 24.0.1-graalce

次に、native プロファイルを使ってビルドします。

mvn -Pnative native:compile

使用例

プロンプトの例は examples/examples.md にあります。

ライセンス

MIT — 詳細は LICENSE をご覧ください。