RunningHub 图像连接器 · RunningHub Image Connector

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

文生图 · 图生图 · 图像编辑 · 放大修复，90+ 图像模型 API

Text-to-image · image-to-image · editing · upscaling — 90+ image model APIs

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

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

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

30 秒判断要不要用：主图详情页要量产、模特图要换背景、老图要放大；排队久、中文提示词水土不服、出图不可控 —— 这个仓库就是为它准备的。 30-second check (EN): Product hero shots, background swaps and 4K upscaling — Chinese prompts work as-is. 下面是它的完整定位、能解决的问题，以及家族里另外 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 客户端 / 开发者：一条 npx 命令，核心引擎经 npm 分发（本仓库是连接器壳，不含引擎源码）：

# 方式一：npx 直接跑（推荐，需要 runninghub-mcp 已发布到 npm）
npx -y runninghub-mcp@latest --scope image

# 方式二：写进 MCP 客户端配置
# { "command": "npx", "args": ["-y", "runninghub-mcp@latest", "--scope", "image"] }

--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: laozhang-image MCP

🐣 保姆级小白指南 / 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-image": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "runninghub-mcp@latest", "--scope", "image"],
      "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

• 「用 seedream 文生图画一张赛博朋克城市夜景」

• 「把这张照片放大到 4K」

• 「用千问图像编辑，把图片背景换成海边」

• "Generate a cyberpunk city night scene with seedream"

• "Upscale this photo to 4K"

• "Change the background to a beach with Qwen image edit"

工具 / Tools

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

仓库结构 / Repo layout

├── connector-meta.json    # WorkBuddy 连接器元信息（中英名称/描述/示例）
├── mcp.json               # MCP 服务器连接配置（指向 npm 上的 runninghub-mcp）
├── token-schema.json      # 用户自填 Token 表单（API Key）
├── icon.svg               # 市场图标（芳字主视觉 + AI芳程式 署名）
├── GUIDE.md / GUIDE_EN.md # 保姆级小白指南（中/英）
├── skills/                # AI 使用说明（SKILL.md）
├── tools/pack.mjs         # 打包成可上传的 zip
└── .github/workflows/     # 打 tag 自动打包发布

🔒 本仓库是连接器壳：只包含安装、配置、指南与使用说明，不包含 MCP 服务器源码。 引擎（npm 包 runninghub-mcp）由作者另行分发，源码闭源。

🔒 This repo is a connector shell: install/config/guides only. The MCP server engine (npm package runninghub-mcp) is distributed separately by the author and is closed-source.

打包提交 / Package & submit

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

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

许可证 / License

MIT © AI芳程式