HanoLab Voice Conversion

HanoLab 集成

为录制的语音和歌声进行音色转换，支持保存私有音色、获取额度报价以及恢复任务结果。

HanoLab · 远程 MCP 指南 · CLI 指南 · 隐私政策 · 支持

此仓库分发公开的连接元数据、两个 Agent 技能，以及来自公开 CLI 版本的客户端源码。托管服务的实现由独立项目维护。

远程 MCP

在支持远程 MCP 和 OAuth 的客户端中，将 https://hanolab.com/mcp 添加为 Streamable HTTP MCP 服务。完成 HanoLab 登录和授权流程。阅读技能说明或复制配置不会连接你的账户，也不会安装工具。

目前，远程 MCP 可使用你账户中已保存的音色转换上传的录音。它可以查看额度和音色、创建私有上传链接、获取转换报价、提交已获批准的转换，以及恢复任务状态或获取输出。它不能克隆新音色，也不会提供购买或更改订阅的功能。

不同客户端的 JSON 格式可能有所不同。mcp.json 是 HTTP 风格的示例；必要时请参阅主机自身的远程服务设置说明。

连接后的请求示例：

• “显示我保存的音色和额度。不要开始转换。”
• “为我的录音生成一个私有上传链接，然后使用我保存的音色获取转换报价。请等待我确认预算。”
• “恢复我们已提交的转换并返回结果。不要开始新的付费任务。”

Agent 技能

使用 Skills CLI 安装两个公开技能：

npx skills add hanolab-ai/hanolab-integrations

或者选择一个：

npx skills add hanolab-ai/hanolab-integrations --skill hanolab-mcp
npx skills add hanolab-ai/hanolab-integrations --skill hanolab

• hanolab-mcp：通过已连接的远程 MCP 工作流进行操作，支持私有浏览器上传、精确报价、确认额度预算以及恢复现有任务。
• hanolab：用于音乐生成、音色克隆/转换、音轨分离、母带处理和可恢复下载的本地终端工作流。需要单独安装 CLI 并具备本地文件访问权限。

本地 CLI

需要 Node.js 20+ 和 HanoLab API 密钥。安装当前版本并以私密方式进行身份验证：

npm install -g https://hanolab.com/downloads/hanolab-cli-0.2.2.tgz
hanolab auth login
hanolab help

CLI 客户端源码复制自公开的 0.2.2 版本。发布校验和可确定确切的可下载构件。客户端向 HanoLab 发送经过身份验证的 API 请求，并以流的形式上传/下载音频；连接账户前，请检查源码和隐私政策。

在账户页面创建密钥，并在终端的隐藏提示处输入。不要将凭据粘贴到聊天或项目文件中。

账户访问与费用

MCP 和 API 目前需要使用现有的 Starter、Creator 或 Pro 账户。音频处理会消耗账户额度；查看额度、已保存的音色和报价不会执行转换。请遵循服务端的测算报价，以及用户明确授权的最高预算。连接成功不会购买套餐，也不会提供无限处理额度。

通过远程 MCP 上传的音频或 MP4 音轨最长支持 15 分钟、最大 100 MB；转换 MP4 后返回的是音频，而不是替换后的视频音轨。只能使用你拥有或有权使用的音色和音频。根据隐私政策的说明，结果会与已连接的 AI 主机共享。

Registry 元数据

server.json 描述了用于官方 MCP Registry 的托管远程端点。仅有源码仓库或配置文件，并不代表已获 Registry 审批、已被第三方收录，或与所有 AI 主机兼容。

更新

确保这些公开技能与 HanoLab 文档中说明的工具及当前 CLI 版本保持一致。公开字段发生变化时，发布新的 Registry 元数据版本。不要将密钥、审核账户凭据、带签名的私有音频链接或托管后端源码添加到此仓库。