Hyperbolic MCP

🚀 ハイパーボリックGPU MCPサーバー

ハイパーボリックのGPUクラウドとやり取りし、エージェントやLLMが利用可能なGPUを表示・レンタルし、SSHで接続し、GPUを使用したワークロードを実行できるようにします。

https://github.com/user-attachments/assets/814d0327-ce5e-4c1b-90bc-7f3712aa1c68

🚀 クイックスタート

📦 インストール

前提条件

• Node.js 16以上
• npmまたはyarn
• ハイパーボリックのAPIトークン
• (オプション) GPUインスタンスに接続するためのSSH秘密鍵

ハイパーボリックアカウントとAPIトークンの取得

1. ハイパーボリックアカウントを登録する:
   • https://app.hyperbolic.xyz/にアクセスします。
   • アカウントを作成するか、既存のアカウントにログインします。
   • メールアドレスを確認します。
2. アカウントに資金を入金する:
   • ハイパーボリックアプリケーションにログインします。
   • 「Billing」タブに移動します。
   • 入金する金額を選択します（初めは25ドルをおすすめします）。
   • 「Pay Now」をクリックします。
   • 指示に従ってアカウントに資金を追加します。
   • GPUインスタンスをレンタルするには十分な資金が必要です。
3. APIトークンを生成する:
   • ハイパーボリックのダッシュボードで「Settings」に移動します。
   • APIキーセクションに移動します。
   • 生成されたトークンをコピーし、安全に保管します。
   • このキーはMCPサーバーの構成環境変数で使用します。
4. SSH公開鍵を追加する:
   • まだ持っていない場合は、SSHキーペアを生成します。
   • ハイパーボリックアプリケーションで「Settings」セクションに移動します。
   • SSH公開鍵セクションまでスクロールします。
   • 公開鍵を貼り付けます（通常は~/.ssh/id_rsa.pubなど）。
   • 保存アイコンをクリックします。

インストール手順

1. このリポジトリをクローンする:

   git clone <your-repo-url>
   cd hyperbolic-mcp
   

2. 依存関係をインストールする:

   npm install
   

3. TypeScriptファイルをビルドする:

   npm run build
   

💻 使用例

基本的な使用法

サーバーをローカルで実行する

サーバーを実行するには、以下のコマンドを実行します。

npm start

Claude for Desktopと接続する

1. Claude for Desktopの設定にサーバーを追加する:

{
  "mcpServers": {
    "hyperbolic-gpu": {
      "command": "node",
      "args": ["/path/to/hyperbolic-mcp-server/build/index.js"],
      "env": {
        "HYPERBOLIC_API_TOKEN": "your-hyperbolic-api-token",
        "SSH_PRIVATE_KEY_PATH": "/path/to/your/privatekey" 
      }
    }
  }
}

2. Claude for Desktopを再起動する。
3. 新しい会話を開始し、サーバーとやり取りする。

注: 環境変数は、上記のようにClaude Desktopの設定を通じて提供するか、プロジェクトのルートに.envファイルを作成することで提供できます。.envファイルは、設定を通じて変数を提供しない場合にのみ必要です。

利用可能なツール

サーバーは以下のツールを提供します。

GPU管理ツール

• list-available-gpus: ハイパーボリックネットワーク上のすべての利用可能なGPUをリストします。
  • 例: "Show me all available GPUs on Hyperbolic."
• rent-gpu-instance: 特定のクラスターからGPUインスタンスをレンタルします。
  • パラメータ:
    • cluster_name: レンタルするクラスターの名前（例: "extrasmall-chamomile-duck"）
    • node_name: ノードの名前（例: "prd-acl-msi-02.fen.intra"）
    • gpu_count: レンタルするGPUの数
  • 例: "I want to rent 4 GPUs from the extrasmall-chamomile-duck cluster."
• terminate-gpu-instance: レンタルしたGPUインスタンスを終了します。
  • パラメータ:
    • instance_id: 終了するインスタンスのID
  • 例: "Terminate my GPU instance with ID abc123."
• list-user-instances: レンタルしたすべてのアクティブなGPUインスタンスをリストします。
  • 例: "Show me all my active GPU instances."
• get-cluster-details: 特定のクラスターに関する詳細情報を取得します。
  • パラメータ:
    • cluster_name: 詳細を取得するクラスターの名前
  • 例: "Tell me more about the cluster called extrasmall-chamomile-duck."

SSHツール

• ssh-connect: リモートサーバーにSSH接続を確立します。
  • パラメータ:
    • host: リモートサーバーのホスト名またはIPアドレス
    • username: 認証用のSSHユーザー名
    • password: (オプション) 認証用のSSHパスワード
    • private_key_path: (オプション) 秘密鍵ファイルのパス
    • port: (オプション) SSHポート番号（デフォルト: 22）
  • 例: "Connect to my GPU instance at 192.168.1.100 as user admin."
• remote-shell: 接続されたリモートサーバーでコマンドを実行します。
  • パラメータ:
    • command: リモートサーバーで実行するコマンド
  • 例: "Run 'nvidia-smi' on the connected server."
• ssh-status: 現在のSSH接続状態を確認します。
  • 例: "What's the status of my SSH connection?"
• ssh-disconnect: アクティブなSSH接続を閉じます。
  • 例: "Disconnect from the SSH server."

セキュリティに関する注意事項

• このサーバーにはハイパーボリックのAPIトークンと、オプションでSSH秘密鍵が必要です。
• これらの資格情報は、Claude Desktopの設定または.envファイルを通じて提供できます。
• サーバーはローカルでのみ実行され、資格情報を外部に公開することはありません。
• GPUをレンタルするコマンドは、ハイパーボリックアカウントに料金が発生します。
• SSH秘密鍵はパスワードで保護されていてはならず、サーバーはパスワードで保護された鍵を処理できません。

トラブルシューティング

問題が発生した場合は、以下のことを確認してください。

1. APIトークンが正しく、期限切れでないことを確認します。
2. ハイパーボリックアカウントに十分なクレジットがあることを確認します。
3. サーバーログにエラーメッセージがないか確認します。
4. ハイパーボリックAPIへのネットワーク接続を確認します。
5. SSHを使用する場合は、秘密鍵のパスが正しく、鍵に適切なパーミッションが設定されていることを確認します。

📄 ライセンス

MITライセンス