prime-intellect-mcp

Claude CodeがPrime IntellectのGPUポッドを自律的にレンタル、操作、終了できるようにします。管理者が設定した厳格な支出上限が適用されます。

概要

Claude Code（または任意のMCPクライアント）をPrime Intellectアカウントに接続するMCPサーバーです。これを使用することで、エージェントは以下の操作が可能になります：

• 🔍 検索: 要件に一致する最も安価なGPUポッドを検索

• 💸 見積もり: 課金前に価格を提示

• 🛒 プロビジョニング: ポッドの作成（confirm=Trueを指定した場合のみ）

• 🖥️ SSH: ポッドへのSSH接続（接続文字列はエージェント自身のBashツールに渡されます）

• 🛑 終了: 作業完了後のポッド終了（終了忘れに対する警告機能付き）

「最も安いH100をレンタルしてトレーニングスクリプトを実行し、終わったら終了して」とClaudeに指示するだけで、400ドルの請求に驚くような事態を防ぐワークフローのために構築されています。

60秒でインストール

Claude Codeを通じてGPUをレンタルし始めるには、以下の手順が必要です：

1. Prime Intellect APIキーを取得する

こちらをクリックして生成 → 権限を以下のように設定します：

キーをコピーしてください（pit_…で始まります）。

2. Claude Codeにサーバーを追加する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）またはプロジェクトの.mcp.jsonを開き、以下を貼り付けます：

{
  "mcpServers": {
    "prime-intellect": {
      "command": "uvx",
      "args": ["prime-intellect-mcp"],
      "env": {
        "PRIME_API_KEY": "pit_PASTE_YOURS_HERE",
        "PRIME_MAX_HOURLY_USD": "5",
        "PRIME_MAX_TOTAL_USD": "40"
      }
    }
  }
}

以上です。Claude Codeを再起動し、「現在1ドル/時間以下で利用可能なGPUは何ですか？」と尋ねてみてください。

uvxがない場合は、curl -LsSf https://astral.sh/uv/install.sh | sh（またはbrew install uv）でインストールしてください。これはuvパッケージマネージャーのワンライナーインストーラーであり、今後仮想環境の管理に悩む必要がなくなります。

✨ SSHの追加（オプション、+2分） — Claudeがポッド上でコードを実行するために必要

上記のサーバーだけでもポッドのプロビジョニング、確認、終了は可能です。しかし、Claude Codeが実行中のポッドにSSH接続してコマンドを実行するには、Prime Intellectがあなたのマシンの公開SSHキーを知っている必要があります。

3. マシン上のSSHキーを確認または生成する

ls ~/.ssh/*.pub          # if you have id_ed25519.pub or similar, you're set
# otherwise:
ssh-keygen -t ed25519 -C "you@example.com"   # press Enter through the prompts

4. 公開キーをPrime Intellectに登録する

cat ~/.ssh/id_ed25519.pub    # or whichever .pub file you have

出力された内容（ssh-ed25519 …で始まる1行）をコピーし、app.primeintellect.ai/dashboard/ssh-keysのAdd SSH keyフォームに貼り付けます。

以上です。今後のポッドにはあなたの公開キーがauthorized_keysに含まれるようになり、Claude CodeのBashツールから直接SSH接続できるようになります：

ssh ubuntu@<pod-ip-from-pod_status> "nvidia-smi"

v0.2で予定: Claude内からステップ4を実行できるregister_ssh_key MCPツール（ブラウザを開く必要がなくなります）。進捗はissueトラッカーで確認できます。

Claudeでできること（9つのツール）

安全性：無断でのプロビジョニングは行われません

以下の3層の保護が適用されます：

1. まず見積もり: pod_quoteは価格と60秒間有効なトークンを返します。副作用はなく、金額はエージェントのコンテキストに保持されます。

2. 明示的な確認: pod_create（およびpod_terminate）にはconfirm=Trueが必要です。これがない場合、ドライランのプレビューのみが行われます。

3. 環境変数による厳格な上限: PRIME_MAX_HOURLY_USDはレートを超えるポッドをブロックします。PRIME_MAX_TOTAL_USDは（レート × 最大稼働時間）が予算を超えるポッドをブロックします。ウォレット残高も強制的にチェックされます。これらの上限はツール引数で上書きすることはできず、呼び出しのたびに読み込まれます。

デフォルト値: PRIME_MAX_HOURLY_USD=5, PRIME_MAX_TOTAL_USD=40。設定ファイルのenvブロックで指定してください。

すべてのpod_create / pod_terminateはJSONとして~/.prime-intellect-mcp/audit.logに追記されるため、エージェントがあなたの資金をどのように使用したかの完全な履歴が残ります。

プロンプト例（Claude Codeに貼り付けてください）

List the cheapest 1×H100 pods available right now. Show me the top 3 by hourly price.

Quote a 1×A100 80GB with 100GB disk, 8 vCPU, 64GB RAM. Don't provision yet —
just show me what it would cost.

I need to fine-tune a 7B model overnight. Find the cheapest 1×H100 with 200GB
disk, max $40 total budget, max 12 hours. Provision it, give me the SSH command,
and remind me to terminate when I'm done.

Check if I have any running pods I forgot about and show me their hourly cost.

Terminate pod abc123. Confirm before doing it.

トラブルシューティング

Claude Codeの設定がenvブロックを読み込めていないか、PRIME_API_KEYという名前が間違っています。以下で確認してください：

$ env | grep PRIME

Claude Codeを起動するのと同じシェルで確認するか、JSONのenvブロックにキーを直接貼り付けてください（${PRIME_API_KEY}を使用する代わりに）。

エージェントが上限を超えるポッドを選択しました。以下のいずれかを行ってください：

• より安いGPUを選択する（list_availabilityでリージョンフィルターを使用すると、より安いコミュニティ価格の行が表示されることがあります）。

• 設定のPRIME_MAX_HOURLY_USDを引き上げ、Claude Codeを再起動する。

見積もりは60秒間有効です。エージェントがpod_quoteとpod_createの間で時間をかけすぎました。再度pod_quoteを呼び出してください（コストはかかりません）。

プロビジョニングが完全に完了していません。ポッドは起動していますが、インストールスクリプトを実行中です。pod_status(pod_id, wait_for_ssh=True)を呼び出すと、SSHが利用可能になるまで（5秒ごとにポーリングして）待機します。

Prime Intellectに公開キーを伝えていないか、登録前にポッドがプロビジョニングされました。修正方法：

1. app.primeintellect.ai/dashboard/ssh-keysで公開キーが登録されているか確認する。

2. 再プロビジョニング — ポッドのauthorized_keysは作成時に設定されるため、登録前に作成されたポッドにはキーが反映されません。

3. 秘密鍵にパスフレーズがある場合は、macOSでssh-add --apple-use-keychain ~/.ssh/your_keyを一度実行してください。これにより、エージェントが自動的にロックを解除できるようになります。

app.primeintellect.ai/walletでチャージしてから再試行してください。

なぜこれが必要なのか？

PyPIにはprime-mcp-server 0.1.2が存在しますが、これは概念実証レベルのものです。本プロジェクトはフォークではありません。夜間などの無人運用における違いは以下の通りです：

ローカル開発

git clone https://github.com/kvrancic/prime-intellect-mcp
cd prime-intellect-mcp
uv sync
uv run pytest -m "not live"        # 32 fast tests, no network, no spend
uv run ruff check .
uv run mypy src

ライブスモークテスト（最も安いGPUをプロビジョニングし、nvidia-smiを実行して終了。約0.05ドルの消費）：

PRIME_API_KEY=pit_... PRIME_LIVE_TEST=1 PRIME_LIVE_MAX_HOURLY=0.60 \
PRIME_MAX_HOURLY_USD=0.60 PRIME_MAX_TOTAL_USD=2.00 \
uv run pytest tests/test_smoke_live.py -v -s

ロードマップ

• v0.2 — register_ssh_key MCPツール（ダッシュボードでの手順を不要にする）、サンドボックス（prime-sandboxes SDK）、Environments Hub

• v0.3 — オプションの自動終了デーモン（サーバー側でのmax_lifetime_hoursの強制）、コストテレメトリ

• v1.0+ — Prime IntellectがOAuthをサポートした際のホスト型/OAuthデプロイ、Anthropicコネクタディレクトリへの提出

謝辞

• Prime Intellect: 作業の90%を担うprime Python SDKを提供

• MIT 6.8610 (Advanced NLP): テストを可能にしたPrime Intellectクレジットを提供

• Anthropic: MCPを提供

• FastMCP: フレームワークを提供

ライセンス

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

貢献

IssueやPRを歓迎します。提出前にuv run pytest -m "not live"とuv run ruff check .を実行してください。