Hyperbolic MCP

🚀 双曲GPU MCP服务器

双曲GPU MCP服务器可让你与双曲（Hyperbolic）的GPU云进行交互，使代理和大语言模型（LLMs）能够查看并租用可用的GPU，通过SSH连接到这些GPU，并为你运行基于GPU的工作负载。

点击查看相关链接

🚀 快速开始

✨ 主要特性

本服务器允许用户与双曲的GPU云交互，具备以下功能：

• 使代理和大语言模型（LLMs）查看和租用可用的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许可证。