HyperAI MCP
通过 Model Context Protocol,在 Claude Code、Cursor 等 AI 工具中直接管理 HyperAI 算力容器、模型部署、数据集与模型。
Model Context Protocol(MCP)是一个开放标准,让 AI 应用能够安全地连接外部服务。AI 工具连接到 MCP 服务器后,可以代表你调用服务器提供的工具——读取数据、执行操作,并把结果直接反馈到对话中。
HyperAI 提供了官方 MCP 服务器,让 Claude Code、Cursor 等 AI 工具可以直接操作 HyperAI 平台：列出和查看你的算力容器、创建或停止工作空间、把模型部署为推理服务、搜索数据集与模型等——全部通过自然语言完成。
HyperAI MCP 服务器
HyperAI MCP 服务器是一个远程服务器,地址为:
https://mcp.hyper.ai它使用 Streamable HTTP 传输协议,无需在本地安装任何东西——只需在 MCP 客户端中添加该 URL,在浏览器中登录 HyperAI 账号即可开始使用。各客户端的配置方法参见连接 HyperAI MCP。
能做什么
服务器的工具分为六个功能组:
| 功能组 | 覆盖范围 |
|---|---|
user | 查询账户档案、配额与限制、账单流水、资源用量与订阅;管理个人访问令牌 |
compute | 列出、查看、创建、停止、重启与删除算力容器——既可在个人账号下,也可通过 username 参数在组织名下操作;创建、更新与删除项目,修改项目可见范围,管理端口映射与闲置超时;读取容器指标、README 与 Notebook |
resources | 搜索公共项目(教程与社区项目) |
dataset | 搜索与查看数据集和模型,包括自有资源和公共资源;创建条目与版本、更新元数据、修改可见范围与删除 |
org | 查询所属组织、组织详情、席位配额与资源限制,列出组织成员 |
serving | 把模型部署为推理服务并管理其版本——创建、发布新版本、重启、扩缩容、停止与删除;查看状态、资源指标与请求遥测;管理访问控制与 API Key |
完整的工具列表及参数说明参见 MCP 工具参考。
认证方式
服务器使用 OAuth 2.1 授权。首次连接时,MCP 客户端会打开浏览器窗口,你需要登录 HyperAI 账号并批准授权。此后所有工具调用都以你自己的账号身份执行——AI 只能查看和操作你的账号有权访问的容器、项目与数据集。登录时会同时签发 refresh token,客户端在后台自动维持会话,正常使用下无需重复登录。
注意
通过 MCP 执行的操作是对账号的真实操作。创建容器会消耗你的算力配额与余额,与在控制台中创建完全一致。在创建或重启容器、创建项目或数据集版本、修改项目或数据集的可见范围、部署或重启模型服务、签发个人访问令牌或模型服务的 API Key、删除数据集、模型服务、项目或容器运行记录之前,助手会先复述即将执行的内容并等待你的明确同意——参见写操作前的确认。
只启用部分功能组
默认启用全部六个功能组。如果只需要其中一部分,可以在注册服务器时给 URL 追加 features 查询参数:
https://mcp.hyper.ai/?features=compute,dataset未知的功能组名称会被忽略。当客户端中工具过多、影响 AI 的注意力时,这个参数可以帮助精简工具列表。