Hyperbolic Mcp

开发 TypeScript

🚀 双曲GPU MCP服务器

本项目可与双曲（Hyperbolic）的GPU云进行交互，允许代理和大语言模型（LLMs）查看和租用可用的GPU，通过SSH连接到这些GPU，并为你运行基于GPU的工作负载。

点击查看相关链接

🚀 快速开始

✨ 主要特性

与双曲的GPU云交互，支持代理和大语言模型查看、租用GPU，通过SSH连接GPU并运行基于GPU的工作负载。

📦 安装指南

前提条件

Node.js 16 或更高版本
npm 或 yarn
双曲API令牌
（可选）用于连接GPU实例的SSH私钥

获取双曲账户和API令牌

注册双曲账户：
- 访问 https://app.hyperbolic.xyz/
- 创建账户或登录现有账户
- 验证你的电子邮件地址
向账户存入资金：
- 登录双曲应用程序
- 导航到“账单”选项卡
- 选择你要存入的金额（建议从25美元开始）
- 点击“立即支付”
- 按照说明向账户添加资金
- 注意，你需要有足够的资金来租用GPU实例
生成API令牌：
- 在双曲仪表板中，导航到“设置”
- 导航到API密钥部分
- 复制生成的令牌并妥善保管
- 你将在MCP服务器配置环境变量中使用此密钥
添加你的SSH公钥：
- 如果你还没有SSH密钥对，请生成一个
- 在双曲应用程序中，导航到“设置”部分
- 向下滚动到SSH公钥部分
- 粘贴你的公钥（通常来自~/.ssh/id_rsa.pub 或类似文件）
- 点击保存图标

安装步骤

克隆此仓库：

git clone 
cd hyperbolic-mcp

安装依赖项：

npm install

构建TypeScript文件：

npm run build

💻 使用示例

基础用法

本地运行服务器

要运行服务器，请执行以下命令：

npm start

与桌面版Claude连接

将服务器添加到你的桌面版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"
}
}
}
}

重启桌面版Claude。
开始新对话并与服务器进行交互。

注意：你可以通过上述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私钥不能受密码保护，因为服务器无法处理受密码保护的密钥。

故障排除

如果你遇到问题，请按以下步骤操作：

检查你的API令牌是否正确且未过期。
确保你的双曲账户有足够的信用额度。
检查服务器日志中的错误消息。
验证你与双曲API的网络连接。
如果你使用SSH，请验证你的私钥路径是否正确，并且密钥具有正确的权限。

📄 许可证

本项目采用 MIT许可证。

0 条评论
分类：开发