runninghub-mcp

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

RunningHub 多模态 AI 能力的 MCP 服务器（Model Context Protocol，stdio），可接入 WorkBuddy、Claude Desktop、Cursor、OpenClaw 等任意 MCP 客户端。

A stdio MCP server exposing RunningHub's 350+ model APIs (image / video / audio / 3D), ComfyUI workflows, AI apps and LLM chat.

30 秒判断要不要用：你已经在用 Claude Desktop / Cursor / WorkBuddy / OpenClaw，想让它直接会画图、剪片、配音、跑 ComfyUI 工作流——装这一个就够了。 30-second check: you already use an MCP client and want it to actually generate images / videos / audio and run ComfyUI workflows — this is the one to install. 下面是它的完整定位、能解决的问题，以及家族里其它 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-mcp.git && cd runninghub-mcp
npm install
node src/cli.js          # 全部能力 / all capabilities
# 或者直接用 npm 包 / or simply: npx -y runninghub-mcp@latest

--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。

一键安装提示词 / One-click install prompt：INSTALL_PROMPT.md

Related MCP server: Replicate-MCP-Server

安装 / Install

npx -y runninghub-mcp@latest                 # 全部能力 / all capabilities
npx -y runninghub-mcp@latest --scope image   # 仅图像 / image only
npx -y runninghub-mcp@latest --scope video   # 仅视频 / video only
npx -y runninghub-mcp@latest --scope audio   # 仅音频 / audio only

MCP 客户端配置示例 / Client config:

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

前置条件 / Prerequisites

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

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

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

工具 / Tools

一键安装提示词 / One-click install prompt：INSTALL_PROMPT.md

环境变量 / Environment variables

本地开发 / Development

npm install
node tools/smoke_test.mjs all     # 协议冒烟测试（不消耗余额）/ protocol smoke test (no credits used)
node tools/e2e_test.mjs           # 真实端到端测试（需 RUNNINGHUB_API_KEY）/ real E2E test
python tools/extract_catalog.py   # 从官方文档重建模型目录 / rebuild catalog

许可证 / License

MIT © AI芳程式