HanoLab Voice Conversion

io.github.obrr-hhx由 GitHub 账号 obrr-hhx 发布v1.0.2更新于 Oct 24, 2026

Convert uploaded speech or singing with your saved HanoLab voices, using OAuth and credit quotes.

已验证Streamable HTTP可网页运行媒体与设计AI 与机器学习

概览

AI 生成的概览

HanoLab 远程 MCP 服务器，让助手用你已保存的声音转换上传的语音或歌声，通过 OAuth 登录并按积分报价执行。

可以做什么
  • 查看已连接账户、套餐与可用积分
  • 列出已保存的声音和最近上传的音频，并生成一小时有效的私密浏览器上传链接
  • 为选定音频与自有声音准备固定积分报价
  • 在用户确认预算后提交转换，轮询任务状态并返回完成的音频链接
  • 查看通过该连接提交的最近转换记录
适用场景
适合让助手用账户中已保存的声音对录制的语音或歌声执行 HanoLab 声音转换，并在消耗积分前先给出报价与预算确认。它不克隆新声音，也不处理购买或订阅变更。
运行要求
需在支持远程 MCP 与 OAuth 的客户端中添加远程 Streamable HTTP 端点，并完成 HanoLab 登录与授权。需要已有的 Starter、Creator 或 Pro 账户。上传通过私密浏览器链接完成，工具无法直接读取本地路径或聊天附件。
安装前请注意
转换会消耗 HanoLab 积分；提交前请确认报价金额与预算上限，中断后复用同一报价以免重复扣费。上传限制为 15 分钟、100 MB，MP4 输入返回的是音频而非替换视频音轨。仅使用你拥有或获授权的声音与音频，结果会按隐私政策共享给所连接的 AI 主机。

安装

在 SourceWeft 中

  1. 打开 控制台中的 HanoLab Voice Conversion，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.obrr-hhx%2Fhanolab/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "hanolab-voice-conversion": {
      "type": "http",
      "url": "https://hanolab.com/mcp"
    }
  }
}

README

HanoLab integrations

Voice conversion for recorded speech and singing, with private saved voices, credit quotes, and resumable results.

HanoLab · Remote MCP guide · CLI guide · Privacy · Support

This repository distributes public connection metadata, two agent skills, and the client source from the public CLI release. The hosted service implementation is maintained separately.

Remote MCP

Add https://hanolab.com/mcp as a Streamable HTTP MCP server in a client that supports remote MCP and OAuth. Complete the HanoLab sign-in and consent flow. Reading a skill or copying a configuration does not connect your account or install tools.

The remote MCP currently converts uploaded recordings using voices already saved in your account. It can inspect credits and voices, create a private upload link, quote a conversion, submit an approved conversion, and recover its status or output. It does not clone a new voice or expose purchases or subscription changes.

The JSON shape varies by client. mcp.json is an HTTP-style example; use the host's own remote-server setup instructions when necessary.

Example requests after connecting:

  • "Show my saved voices and credits. Do not start a conversion."
  • "Give me a private upload link for my recording, then quote conversion using my saved voice. Wait for my budget confirmation."
  • "Recover the conversion we already submitted and return its result. Do not start a new paid task."

Agent skills

Install both public skills using the Skills CLI:

sh
npx skills add hanolab-ai/hanolab-integrations

Or select one:

sh
npx skills add hanolab-ai/hanolab-integrations --skill hanolab-mcpnpx skills add hanolab-ai/hanolab-integrations --skill hanolab
  • hanolab-mcp: the connected remote MCP workflow, private browser uploads, exact quotes, confirmed credit budgets, and resuming existing tasks.
  • hanolab: local terminal workflow for music generation, voice cloning/conversion, stem separation, mastering, and resumable downloads. Requires a separately installed CLI and local file access.

Local CLI

Requires Node.js 20+ and a HanoLab API key. Install the current release and authenticate privately:

sh
npm install -g https://hanolab.com/downloads/hanolab-cli-0.2.2.tgzhanolab auth loginhanolab help

The CLI client source is copied from the public 0.2.2 release. Release checksums identify the exact downloadable artifact. The client sends authenticated API requests to HanoLab and streams audio uploads/downloads; inspect the source and the privacy policy before connecting your account.

Create the key on the account page and enter it at the hidden terminal prompt. Do not paste credentials into a chat or a project file.

Account access and cost

MCP and API access currently use an existing Starter, Creator, or Pro account. Audio processing consumes the account's credits; checking credits, saved voices, and a quote does not execute a conversion. Follow the server's measured quote and the user's explicitly authorized maximum budget. A successful connection does not purchase a plan or supply unlimited processing.

Uploads through remote MCP support audio or MP4 soundtracks up to 15 minutes and 100 MB; MP4 conversion returns audio rather than a replaced video soundtrack. Only use voices and audio you own or have permission to use. Results are shared with the connected AI host as described in the privacy policy.

Registry metadata

server.json describes the hosted remote endpoint for the official MCP Registry. A source repository or configuration file by itself does not indicate registry approval, third-party listing, or compatibility with every AI host.

Updating

Keep these public skills aligned with HanoLab's documented tools and current CLI release. Publish a new registry metadata version when its public fields change. Do not add secrets, review-account credentials, signed private audio links, or hosted backend source to this repository.

来源：README.md，提交 5282218

工具

9

get_profile

Connected account

Identify the HanoLab account connected to these tools.

无需输入参数。

get_credits

Credit balance

Read the connected account’s plan and available credits. Does not purchase credits.

无需输入参数。

list_voices

Saved voices

List the connected user’s own saved voices and whether they are ready. If none are ready, open voicelab to create one.

无需输入参数。

list_audio

Uploaded audio

List recent audio uploaded through this connection. Use the exact audio_id, never a local path or an arbitrary URL.

无需输入参数。

prepare_voice_conversion

Estimate voice conversion

Prepare a fixed quote for uploaded audio and a ready owned voice. No credits are spent. Explain estimated_credits, obtain the user’s budget and explicit confirmation, then use convert_voice with this exact quote_id.

输入参数audio_id必填voice_id必填full_song

convert_voice

Convert voice

Spend HanoLab credits to submit the prepared conversion ONLY after the user confirms its cost and budget. Reuse the exact quote_id after interruption: repeated calls return the original task without another debit. A failed task needs a separate user decision before a new quote.

输入参数quote_id必填confirmed必填max_credits必填

get_task

Conversion status and results

Check an owned task and return completed audio links. Refreshes worker status and may persist completion or a failure refund. Poll about every 10 seconds; do not submit a new paid task while waiting.

输入参数task_id必填

list_conversions

Recent conversions

Find recent conversions submitted with this connection. Use get_task to refresh a task. This does not start new tasks.

无需输入参数。

版本历史

2
  1. v1.0.2最新Oct 14, 2026
  2. v1.0.0Oct 14, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。