Massed Compute Mcp

Massed Compute MCP サーバー

Model Context Protocol サーバーです。AI アシスタント（Claude、Cursor、Codex、ChatGPT、その他の MCP 対応クライアント）が、Massed Compute アカウントを操作できるようにします。GPU インベントリの閲覧、VM の起動と管理、請求の監査、セットアップレシピの検索が可能です。

目次

• 概要
• インストール
• 接続の確認
• CLI リファレンス
• キーの解決
• リソース
• ライセンス

概要

このリポジトリから公開されているパッケージは、https://vm.massedcompute.com/api/mcp の公開 MCP エンドポイントをそのままプロキシするもので、機能の追加は一切ありません。すべての JSON-RPC メッセージ（initialize、tools/list、tools/call、resources/list、resources/read、ping、…）は、保存済みの API キーを Bearer ヘッダーとして注入したうえで変更せずに転送され、レスポンスも変更せずに返されます。処理の過程で、何かが追加、改名、フィルタリング、書き換えされることはありません。

• カタログはホストされたエンドポイントが管理します。 ツール、リソース、スキーマ、説明は稼働中のエンドポイントから取得されるため、セットアップレシピなどの新機能が上流で公開されても、ローカルパッケージが古くなることはありません。
• セキュリティはホストされたエンドポイントが管理します。 キーのスコープ適用（読み取り専用キーでは破壊的なツールが非表示になります）と認証情報の秘匿はサーバー側で行われ、どのクライアントでも同じように適用されます。
• ローカルパッケージが追加するのは、stdio クライアントに必要な機能だけです。 stdio とストリーム可能な HTTP 間のブリッジ、API キーの OS 慣例に沿った保存（POSIX では 0600）、init によるクライアント設定の一括処理です。

分析専用のアシスタントには読み取り専用キーを発行してください。エンドポイントは、破壊的なツール呼び出し（起動、再起動、終了、SSH キーの変更）を呼び出し時に拒否します。Claude Code、Claude Desktop、Cursor、Codex で動作します。massed-compute-mcp tools を実行すると、GPU インベントリ、VM イメージ、インスタンスのライフサイクル、クーポン、請求、SSH キー、セットアップレシピなど、最新のカタログが表示されます。

生のツールに加えて、Massed Compute は GPU の選択やコスト監査など、一般的な操作のための Markdown ワークフローテンプレートであるエージェントスキルを公開しています。詳しいドキュメントはvm-docs.massedcompute.com/docs/category/mcpをご覧ください。

インストール

手順 1. API キーを取得する

vm.massedcompute.com/settings/apiを開き、キーを作成してコピーします（分析専用のアシスタントには読み取り専用キー、起動／再起動／終了／SSH キーの変更を許可する場合はフルアクセスキーを使用します）。

手順 2. インストール方法を選ぶ

• ホストされたエンドポイント — クライアントをストリーム可能な HTTP URL に接続します。インストールは不要です
• ローカル CLI — マシン上で実行し、キーは OS の設定ディレクトリに保存されます

ホストされたエンドポイント

ローカルパッケージはこのエンドポイントをそのままプロキシするため、クライアントを直接接続すれば、インストール不要で同じカタログを利用できます。クライアントに対応する設定例を選んでください。

Claude Code

claude mcp add --transport http massed-compute \
  https://vm.massedcompute.com/api/mcp \
  --header "Authorization: Bearer MC_TOKEN"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "massed-compute": {
      "url": "https://vm.massedcompute.com/api/mcp",
      "headers": { "Authorization": "Bearer MC_TOKEN" }
    }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.massed-compute]
url = "https://vm.massedcompute.com/api/mcp"
bearer_token_env_var = "MC_TOKEN"
enabled = true

Claude Desktop

Claude Desktop はまだストリーム可能な HTTP MCP に対応していないため、stdio と HTTP 間のブリッジとして mcp-remote を使用してください。設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）です。

{
  "mcpServers": {
    "massed-compute": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://vm.massedcompute.com/api/mcp",
        "--header", "Authorization: Bearer MC_TOKEN"
      ]
    }
  }
}

ローカル CLI

お好みのエコシステムを使ってインストールします。

npm install -g massed-compute-mcp     # Node >= 20
# or
pip install massed-compute-mcp        # Python >= 3.10
# or
uv tool install massed-compute-mcp    # fast Python install via uv

初回セットアップを実行します。

massed-compute-mcp init

init はキーの入力を求め、アップストリームで検証し、0600（POSIX）で保存します。また、インストール済みの MCP クライアント（Claude Code、Cursor、Claude Desktop、Codex）を検出し、それぞれに設定を追加するかどうかを確認します。クライアントを編集する前に、タイムスタンプ付きのバックアップが作成されます。ツールを利用するには、設定を追加したクライアントを再起動してください。

設定ファイルの場所：

• Linux：$XDG_CONFIG_HOME/massed-compute/config.json（未設定の場合は ~/.config/...）
• macOS：~/Library/Application Support/massed-compute/config.json
• Windows：%APPDATA%\massed-compute\config.json

非対話モード（CI／スクリプト）：

# Key from env, auto-wire every detected client
MASSED_COMPUTE_API_KEY=<your-key> massed-compute-mcp init --yes

# Key from a file, wire only specific clients
massed-compute-mcp init --token-file ~/keys/mc --yes --clients claude-code,cursor

# Store the key only; don't touch any client config
massed-compute-mcp init --yes --no-install-clients

後からクライアントを追加または削除する場合：

massed-compute-mcp install-client cursor       # claude-desktop | codex | claude-code
massed-compute-mcp uninstall-client cursor

install-client は冪等です。エントリがすでに一致している状態で再実行しても、何もせずに終了します。

接続の確認

massed-compute-mcp doctor

doctor は、保存済みのキーが引き続き有効かを確認し、ツールカタログを表示するとともに、自動で設定しなかったクライアント用のコピー＆ペースト可能なスニペットを表示します。または、アシスタントに 「Massed Compute API キーを検証してください。」 と尋ねてください。{ message: "Valid Token" } という応答があれば、設定は完了です。

CLI リファレンス

コマンド	動作
massed-compute-mcp (引数なし)	stdio 経由で MCP サーバーを実行します
massed-compute-mcp init	初回セットアップ：入力、検証、保存、クライアントへの設定
massed-compute-mcp doctor	保存済みのキーを検証し、クライアント用スニペットを表示します
massed-compute-mcp install-client <id>	単一のクライアントに設定します（claude-code、cursor、claude-desktop、codex）
massed-compute-mcp uninstall-client <id>	クライアント設定から当ツールのエントリを削除します
massed-compute-mcp config show	解決された設定パス、マスクされたキー、解決チェーンを表示します
massed-compute-mcp logout	保存済みの API キーを削除します
massed-compute-mcp tools [--json]	ホストされたエンドポイントから最新のツールカタログを取得して表示します
massed-compute-mcp version	バージョンを表示します

キーの解決

サーバーの起動時には、次のうち最初に値が設定されている場所から API キーを取得します。

1. --token <value> CLI フラグ
2. --token-file <path> CLI フラグ（1 行目をトリミング）
3. MASSED_COMPUTE_API_KEY 環境変数
4. init によって書き込まれた設定ファイル

いずれも設定されていない場合、サーバーは massed-compute-mcp init を案内して 0 以外の終了コードで終了します。アップストリームは MASSED_COMPUTE_API_BASE_URL で上書きできます（デフォルトは https://vm.massedcompute.com）。

リソース

• MCP ドキュメント全文
• Massed Compute API リファレンス
• Massed Compute コンソール
• Model Context Protocol 仕様

ライセンス

MIT — LICENSE を参照してください。