Hyperbolic MCP

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

このサーバーを使用すると、ハイパーボリックのGPUクラウドとやり取りが可能になり、エージェントや大規模言語モデル (LLM) が利用可能なGPUを表示・レンタルし、SSHで接続し、GPUを利用したワークロードを実行できます。

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

🚀 クイックスタート

✨ 主な機能

• ハイパーボリックのGPUクラウドとのやり取りを可能にする。
• エージェントやLLMがGPUの表示、レンタル、SSH接続、ワークロード実行を行える。

📦 インストール

前提条件

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

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

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