Hyperbolic MCP

🚀 雙曲GPU MCP服務器

本項目可與雙曲（Hyperbolic）的GPU雲進行交互，允許代理和大語言模型（LLMs）查看和租用可用的GPU，通過SSH連接到這些GPU，併為你運行基於GPU的工作負載。

點擊查看相關鏈接

🚀 快速開始

✨ 主要特性

與雙曲的GPU雲交互，支持代理和大語言模型查看、租用GPU，通過SSH連接GPU並運行基於GPU的工作負載。

📦 安裝指南

前提條件

• Node.js 16 或更高版本
• npm 或 yarn
• 雙曲API令牌
• （可選）用於連接GPU實例的SSH私鑰

獲取雙曲賬戶和API令牌

1. 註冊雙曲賬戶：
   • 訪問 https://app.hyperbolic.xyz/
   • 創建賬戶或登錄現有賬戶
   • 驗證你的電子郵件地址
2. 向賬戶存入資金：
   • 登錄雙曲應用程序
   • 導航到“賬單”選項卡
   • 選擇你要存入的金額（建議從25美元開始）
   • 點擊“立即支付”
   • 按照說明向賬戶添加資金
   • 注意，你需要有足夠的資金來租用GPU實例
3. 生成API令牌：
   • 在雙曲儀表板中，導航到“設置”
   • 導航到API密鑰部分
   • 複製生成的令牌並妥善保管
   • 你將在MCP服務器配置環境變量中使用此密鑰
4. 添加你的SSH公鑰：
   • 如果你還沒有SSH密鑰對，請生成一個
   • 在雙曲應用程序中，導航到“設置”部分
   • 向下滾動到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連接

1. 將服務器添加到你的桌面版Claude配置中：

{
  "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。
3. 開始新對話並與服務器進行交互。

注意：你可以通過上述Claude桌面配置或在項目根目錄創建一個.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桌面配置或.env文件提供。
• 服務器僅在本地運行，不會將你的憑據暴露給外部。
• 租用GPU的命令將在你的雙曲賬戶上產生費用。
• SSH私鑰不能受密碼保護，因為服務器無法處理受密碼保護的密鑰。

故障排除

如果你遇到問題，請按以下步驟操作：

1. 檢查你的API令牌是否正確且未過期。
2. 確保你的雙曲賬戶有足夠的信用額度。
3. 檢查服務器日誌中的錯誤消息。
4. 驗證你與雙曲API的網絡連接。
5. 如果你使用SSH，請驗證你的私鑰路徑是否正確，並且密鑰具有正確的權限。

📄 許可證

本項目採用 MIT許可證。