RunningHub 音频连接器 · RunningHub Audio Connector

开发者：AI芳程式 ｜ 问题反馈或建议：zzdh518 Developer: AI芳程式 (AI Fangchengshi) ｜ Feedback & suggestions: zzdh518

语音合成 · 音乐生成 · 声音克隆 · 歌词 · 人声分离，50+ 音频模型 API

TTS · music generation · voice cloning · lyrics · stem separation — 50+ audio model APIs

🔊 品类 / Category：音频 · 50+ 音频模型 ｜ 形态 / Form：WorkBuddy 连接器包（MCP + Skill）＋ 自带 server/ 源码，可完全独立部署

面向 WorkBuddy 连接器市场的成品提交包（MCP + Skill 方案），同时适用于任意支持 MCP 的客户端。底层 MCP 服务器来自 runninghub-mcp，通过 --scope audio 限定能力范围。

A ready-to-submit WorkBuddy connector package (MCP + Skill). The underlying MCP server is runninghub-mcp, restricted to --scope audio.

30 秒判断要不要用：配音要买音色包、BGM 怕版权、人声分离要装专业软件；三条链路三个账号，成本高还没法批量 —— 这个仓库就是为它准备的。 30-second check (EN): Voiceover, music and stem separation in one place — no voice packs to buy. 下面是它的完整定位、能解决的问题，以及家族里另外 5 个仓库。Below: what this repo is, what it solves, and the other five repos in the family.

🧭 本仓库在家族里的位置 / Where this repo fits

🚀 两种用法 / Two ways to use it

A. 只装这一个（独立部署，最小依赖） — 你只想在这一个品类上用 AI：

• WorkBuddy 用户：在连接器市场搜「RunningHub」，装这一个就行（见下方「安装」）。

• 任意 MCP 客户端 / 开发者：克隆本仓库即可完全本地运行，不依赖任何已发布的 npm 包：

git clone https://github.com/fancy5166/runninghub-audio-connector.git && cd runninghub-audio-connector
npm install
node server/cli.js --scope audio

--scope 让后端只加载本品类模型：启动更快、上下文更省、也更不容易挑错模型。

B. 家族联动（图 + 视频 + 音频一次到位） — 你想让 AI 一次干完整条链路：

同一个 API Key 下装多个连接器，或在 WorkBuddy 里直接装全能连接器 runninghub-connector——一个顶四个；开发者还可以直接用核心引擎 runninghub-mcp 自己拼。

🔗 家族全部仓库 / The whole family

💡 不确定装哪个？ 先装全能连接器 runninghub-connector 一个就够； 只做图片就装 runninghub-image-connector， 只做视频装 runninghub-video-connector， 只做配音/音乐装 runninghub-audio-connector， 要自己二次开发从 runninghub-mcp 入手。

全部由 AI芳程式 开发，问题反馈或建议请联系 zzdh518。

Related MCP server: MCP Server Whisper

🐣 保姆级小白指南 / Beginner's guides

• 中文：GUIDE.md — 完全没用过 AI 产品也能照着用起来

• English: GUIDE_EN.md — step-by-step for absolute beginners

前置条件 / Prerequisites

1. API Key — 在 RunningHub API 管理页面 点「新建」创建

2. 账户余额 — 用邀请码注册即送 500 RH 币（可免费生成不少图片和视频）；用完后到 RunningHub 官网 充值

3. 还没有账号？RunningHub 邀请注册链接 —— 填写邀请码 zlhtnu0f，可得 500 RH 币，可以免费生成不少图片和视频哦！

安装 / Install

WorkBuddy 连接器市场：搜索「音频连接器」安装，连接时粘贴 API Key。

手动配置 / Manual MCP config：

{
  "mcpServers": {
    "runninghub-audio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "runninghub-mcp@latest", "--scope", "audio"],
      "env": { "RUNNINGHUB_API_KEY": "你的 API Key / your API key" }
    }
  }
}

一键安装 / One-click install：把 INSTALL_PROMPT.md 里的提示词复制给你的 AI Agent，它会自动安装并引导配置。Copy the prompt from INSTALL_PROMPT.md into your agent.

能做什么 / What you can ask

• 「用 MiniMax TTS 把这段文案转成温柔女声」

• 「用 Suno 生成一首轻快的流行歌」

• 「把这首歌的人声和伴奏分离」

• "Convert this copy into a gentle female voice with MiniMax TTS"

• "Generate an upbeat pop song with Suno"

• "Separate vocals and instrumental from this song"

工具 / Tools

7 个工具（模型检索 / 提交 / 等待 / 上传下载），详见 skills/audio-usage/SKILL.md 与 runninghub-mcp 工具表。

仓库结构 / Repo layout

├── connector-meta.json    # WorkBuddy 连接器元信息（中英名称/描述/示例）
├── mcp.json               # MCP 服务器连接配置
├── token-schema.json      # 用户自填 Token 表单（API Key）
├── icon.svg               # 市场图标（芳字主视觉 + AI芳程式 署名）
├── GUIDE.md / GUIDE_EN.md # 保姆级小白指南（中/英）
├── skills/                # AI 使用说明（SKILL.md）
├── server/                # ★ 内置 MCP 服务器源码（本仓库独立可跑，不依赖任何已发布包）
├── data/catalog.json      # ★ 内置模型目录（本仓库独立可跑）
├── package.json           # ★ 独立包定义（npm start → node server/cli.js --scope audio）
├── tools/pack.mjs         # 打包成可上传的 zip（自动排除 server/ data/ 等独立包文件）
└── .github/workflows/     # 打 tag 自动打包发布

★ 标记的文件是本仓库「独立部署」能力的来源：克隆下来 npm install && npm start 即可作为独立 MCP 服务器运行， 不依赖 npm 上是否已发布 runninghub-mcp。打 WorkBuddy 连接器 zip 时这些文件会被自动排除，包体保持精简。

★ marked files make this repo standalone: npm install && npm start runs it as its own MCP server without relying on any published npm package. They are excluded from the WorkBuddy connector zip.

打包提交 / Package & submit

node tools/pack.mjs        # 生成 dist/runninghub-audio-<version>.zip

把 zip 上传到 WorkBuddy 开发者后台审核即可。Upload the zip to the WorkBuddy developer backend.

许可证 / License

MIT © AI芳程式