ComputeNexa

ComputeNexa MCP サーバー

AI アシスタントがComputeNexaでプライベート GPU を検索、起動、停止できるようにします。「48 GB 以上の GPU で在庫があるものは？」「データサイエンス環境で最も安いものを 2 時間起動して」「停止して」と尋ねると、チームの API キーを使い、起動ごとの料金を表示します。支払いが発生するのは、あなたが承認した後だけです。

Claude Desktop、Claude Code、Cursor、VS Code、および Model Context Protocolに対応するその他のアシスタントで使えます。サーバーはお使いのコンピューター上で動作し、ComputeNexa API と通信します。キーはご自身の設定内に保持されます。

セットアップ

1. ComputeNexa ダッシュボードでAPI keysを開き、キーを作成します。
   • Look onlyは、GPU、マシン、支出を確認する場合に選択します。
   • Launch and stopは、マシンの起動、延長、停止も行う場合に選択します。
2. uvをインストールします（サーバーの実行にはuvxを使うため、別途インストールする必要はありません）。
3. 以下の手順でアシスタントにサーバーを追加し、キーをCNX_API_KEYとして設定します。

Claude Code

claude mcp add --env CNX_API_KEY=cnxk_... --transport stdio computenexa -- uvx computenexa-mcp

すべてのプロジェクトで使うには、--scope userを追加します。

Claude Desktop

設定 → Developer → Edit config（claude_desktop_config.json）：

{
  "mcpServers": {
    "computenexa": {
      "command": "uvx",
      "args": ["computenexa-mcp"],
      "env": { "CNX_API_KEY": "cnxk_..." }
    }
  }
}

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または.cursor/mcp.json（1 つのプロジェクト）に、Claude Desktop と同じmcpServersエントリを追加します。

VS Code

.vscode/mcp.jsonを使用します。VS Code がキーを一度だけ尋ね、ファイルには保存しません。

{
  "inputs": [
    { "type": "promptString", "id": "cnx-key", "description": "ComputeNexa API key", "password": true }
  ],
  "servers": {
    "computenexa": {
      "type": "stdio",
      "command": "uvx",
      "args": ["computenexa-mcp"],
      "env": { "CNX_API_KEY": "${input:cnx-key}" }
    }
  }
}

できること

ツール	機能	キー
whoami	メールアドレス、チーム、残高、GPU 上限、キーの権限を表示します	任意
list_gpus	リアルタイムの価格と在庫を含む GPU を、安い順に表示します。アプリ、リージョン、メモリで絞り込めます	任意
list_apps	GPU の起動時に使えるアプリ、そのモデル、インストール済みの項目を表示します	任意
list_machines · get_machine	マシンと接続方法（SSH、ブラウザーアプリ、API、エンドポイントアドレス）を表示します	任意
get_usage · list_receipts	支出と GPU 時間、終了したセッションとその料金を表示します	任意
list_projects · list_endpoints	保存済みプロジェクト、エンドポイント、および各エンドポイントが指すマシンを表示します	任意
launch_machine	GPU を起動します（最初に見積もりを取得し、承認後に起動します）	起動と停止
extend_machine	利用時間を延長します（最初に見積もりを取得します）	起動と停止
set_keep_running	停止するまでマシンを自動更新します（最初に見積もりを取得します）	起動と停止
stop_machine	マシンをすぐに終了します。未使用時間分は返金されます	起動と停止
create_endpoint · get_endpoint_key	自分のサーバー用の固定 HTTPS アドレスと、そのキーを取得します	起動と停止

参照専用のキーで使えるのは、読み取りツール（最初の 6 行）のみです。

安全性

• あなたの承認なしに料金が請求されることはありません。 launch_machine、extend_machine、set_keep_runningは、最初に見積もりを返します。たとえば、「データサイエンスアプリを使う NVIDIA RTX A6000、2 時間：今すぐ $1.44（$0.72/時）が請求されます。早期に停止した場合、未使用時間分は返金されます。」 と表示されます。confirm=trueと見積もり合計金額を指定した 2 回目の呼び出しでのみ処理が進みます。その間に価格が上がった場合は拒否されます。
• 1 回の呼び出しごとに上限があります。 起動、延長、または自動更新の料金が**$25**を超える場合、拒否されます。サーバーのenvにあるCNX_MCP_MAX_LAUNCH_USD（ドル単位）で変更できます。チームの GPU 上限とプリペイド残高も引き続き適用されます。
• API キーがツールの結果に表示されることはありません。 エンドポイントキーは、エンドポイントの作成時、またはキーを求めた場合にのみ表示されます。
• 料金の発生やマシンの終了につながるツールには、その旨が示されるため、アシスタントは使用前に確認を求めます。

設定

変数
CNX_API_KEY	必須。ComputeNexa API キー（cnxk_…）
CNX_MCP_MAX_LAUNCH_USD	1 回の呼び出しで使える最大金額（米ドル）。デフォルトは25です
CNX_API_URL	別の ComputeNexa API に対するテスト時のみ使用します

Develop

uv sync
uv run pytest
uv run ruff check src tests

Built on the ComputeNexa Python SDK and the official MCP Python SDK.

Questions: [email protected] · Security issues: see SECURITY.md.