runninghub-image
Provides access to TED talks transcripts metadata assembly stderr generated unusual provenance.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@runninghub-imageGenerate a cyberpunk city night scene with seedream"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
本仓库 / This repo | 🎨 runninghub-image-connector — 图像连接器 |
品类 / Category | 图像 · 90+ 图像模型 |
形态 / Form | WorkBuddy 连接器包(MCP + Skill)+ 自带 server 源码,可完全独立部署 |
独立可用 / Standalone | ✅ 不需要任何其它仓库,克隆本仓库即可跑起来 |
联动可用 / Interop | ✅ 与家族其它 5 个仓库共用同一套 RunningHub 账号与 API Key,可任选组合安装 |
适合谁 / Who it's for | 电商设计 / 社媒运营 / 插画师 / 品牌视觉 |
解决的痛点 / Pain it kills | 主图详情页要量产、模特图要换背景、老图要放大;排队久、中文提示词水土不服、出图不可控。 |
给你的价值 / What you get | 90+ 图像模型(Seedream / 千问 / 悠船 / Topaz)随选随切,文生图、图生图、精修、4K 放大全在一个对话里,中文提示词原样可用。 |
🚀 两种用法 / Two ways to use it
A. 只装这一个(独立部署,最小依赖) — 你只想在这一个品类上用 AI:
WorkBuddy 用户:在连接器市场搜「RunningHub」,装这一个就行(见下方「安装」)。
任意 MCP 客户端 / 开发者:克隆本仓库即可完全本地运行,不依赖任何已发布的 npm 包:
git clone https://github.com/fancy5166/runninghub-image-connector.git && cd runninghub-image-connector
npm install
node server/cli.js --scope image
--scope让后端只加载本品类模型:启动更快、上下文更省、也更不容易挑错模型。
B. 家族联动(图 + 视频 + 音频一次到位) — 你想让 AI 一次干完整条链路:
同一个 API Key 下装多个连接器,或在 WorkBuddy 里直接装全能连接器 runninghub-connector——一个顶四个;开发者还可以直接用核心引擎 runninghub-mcp 自己拼。
🔗 家族全部仓库 / The whole family
仓库 / Repo | 品类 / Category | 一句话 / In one line | |
🏠 | 家族总入口 · 源码真源 | 6 个包的源码 + 4 个可直接上传 WorkBuddy 的连接器 zip,一次拿全 | |
⚙️ | 核心引擎 · MCP 服务器(npm 包,非连接器) | 给任何 MCP 客户端装上 RunningHub 的 350+ 模型双手 | |
🧰 | 全能 · 图 + 视 + 音 + 3D + 工作流 + LLM | 一个连接器顶掉一堆账号:350+ 模型,一句话从出图切到出片再切到配音 | |
🎬 | 视频 · 200+ 视频模型 | 一条片子不用换五个平台,首尾帧与数字人口播全覆盖 | |
🔊 | 音频 · 50+ 音频模型 | 配音、配乐、人声分离一站搞定,不用买音色包 |
💡 不确定装哪个? 先装全能连接器 runninghub-connector 一个就够; 只做图片就装 runninghub-image-connector, 只做视频装 runninghub-video-connector, 只做配音/音乐装 runninghub-audio-connector, 要自己二次开发从 runninghub-mcp 入手。
全部由 AI芳程式 开发,问题反馈或建议请联系 zzdh518。
Related MCP server: Multi-Provider Image Generation Server
🐣 保姆级小白指南 / Beginner's guides
中文:GUIDE.md — 完全没用过 AI 产品也能照着用起来
English: GUIDE_EN.md — step-by-step for absolute beginners
前置条件 / Prerequisites
API Key — 在 RunningHub API 管理页面 点「新建」创建
账户余额 — 用邀请码注册即送 500 RH 币(可免费生成不少图片和视频);用完后到 RunningHub 官网 充值
还没有账号?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 服务器连接配置
├── 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 image)
├── 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 startruns 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-image-<version>.zip把 zip 上传到 WorkBuddy 开发者后台审核即可。Upload the zip to the WorkBuddy developer backend.
许可证 / License
MIT © AI芳程式
Available Tools
7 toolsrunninghub_download_fileC
把任务结果文件(URL)下载到本地指定路径。
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 结果文件 URL | |
| savePath | Yes | 保存到的本地绝对路径(含文件名) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It does not disclose whether an existing file at savePath is overwritten, whether the parent directory must exist, required auth, or rate/ size limits — all relevant for a file-download mutation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence with the action front-loaded and no wasted wording. It is efficient, though it carries no structural elaboration such as caveats or return behavior.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple 2-parameter tool with no output schema and full schema coverage, the description is barely adequate. It omits the behavioral details (overwrite, directory existence, failure modes) that matter when no annotations exist.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both 'url' and 'savePath' are already documented in the schema, including the 'absolute path incl. filename' constraint. The description adds no extra format or semantics beyond that baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (下载/download) and resource (任务结果文件/task result file) plus the destination (本地指定路径). It clearly reads as the counterpart to runninghub_upload_file among the siblings, though it does not explicitly name any sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this versus alternatives, no prerequisites, and no mention of what must happen first (e.g. that a task must have produced a result URL). Usage is only inferable from the tool name and the '任务结果' qualifier.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_list_modelsC
按类别浏览 RunningHub 模型目录。category=image|video|audio|other。
| Name | Required | Description | Default |
|---|---|---|---|
| group | No | 可选分组过滤 | |
| limit | No | 返回条数上限 | |
| category | Yes | 模型类别 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations, so the description carries the full burden. It doesn't disclose read-only safety, pagination behavior (despite limit default 40), rate limits, or authentication needs. 'Browse' weakly implies a read, but no behavioral traits beyond the schema are provided.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, front-loaded with the core action. The second sentence duplicates the category enum from the schema, so it doesn't fully earn its place, but there's no filler text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the definition should do more to explain what is returned, how pagination works, and when to choose this over search_models. The description leaves those gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description repeats the category enum already defined in the schema and adds no semantics for group or limit.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (browse) and resource (RunningHub model catalog) scoped by category. It implicitly contrasts with search_models by emphasizing category browsing, but never names the sibling or the query-based alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides no when-to-use guidance, no exclusions, and does not mention the sibling runninghub_search_models. The only routing signal is the word 'browse', leaving the agent to infer that this is for enumeration rather than keyword search.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_query_taskA
查询 RunningHub 任务状态与结果(单次查询)。v2 用于标准模型任务;legacy 用于工作流/AI 应用任务。
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | 任务 ID | |
| apiVersion | No | 查询接口版本:v2=标准模型 API 任务(/openapi/v2/query);legacy=工作流/AI应用任务(/task/openapi/outputs)。不确定时先试 v2,失败再用 legacy | v2 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses the key behavioral trait that this is a single, non-blocking query, but says nothing about auth/permission requirements, rate limits, what happens when the task is still running, or result availability.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short, front-loaded sentences with zero filler; the core purpose comes first and the version distinction follows immediately.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a 2-parameter query tool whose params are fully documented, but with no output schema and no annotations, the description should say more about what is returned and the behavior when a task is incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both parameters (taskId, apiVersion) are already documented in the schema, including the fallback advice for apiVersion. The description merely restates the version split at a higher level, adding no syntax or format detail beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: querying RunningHub task status and results, with the parenthetical '单次查询' clarifying it is a one-shot poll rather than a blocking wait. It implicitly distinguishes from runninghub_wait_task, though it never names that sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives when-to-use guidance for the two apiVersion values (standard model tasks vs workflow/AI app tasks), which is useful selection context. However, it offers no guidance on choosing this tool over runninghub_wait_task or runninghub_submit_task, so tool-level routing is only implied by '单次查询'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_search_modelsB
搜索 RunningHub 模型目录(350+ 标准模型 API 端点)。按关键词/类别/分组查找模型,返回可用的 endpoint 与说明。类别:image=图像、video=视频、audio=音频、other=其他(3D 等)。找到模型后用 runninghub_submit_task 提交任务。
| Name | Required | Description | Default |
|---|---|---|---|
| group | No | 分组过滤,如 text-to-image、image-to-video、text-to-audio | |
| limit | No | 返回条数上限,默认 20 | |
| keyword | No | 关键词,如 seedream、可灵、数字人、对口型、tts、suno | |
| category | No | 限定类别,默认不限定 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a safe read operation and discloses the return content (endpoints plus descriptions) and a filterable catalog size, but says nothing about pagination behavior, ordering, or result caps beyond the limit parameter.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loads the core purpose and catalog scale, then the category legend, then the next-step tool. Every sentence is functional, though the category enumeration could arguably live in the enum description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description must convey the return shape, and '返回可用的 endpoint 与说明' is minimal — enough to know endpoints come back, but not the result structure or ordering. It covers the essential next step but leaves gaps an agent would need to probe.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description does add value by glossing the category enum (image=图像、video=视频、audio=音频、other=其他), but it adds nothing for keyword, group, or limit beyond what the schema already documents.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (搜索) and resource (模型目录), plus scope details (350+ 标准模型 API 端点) and what is returned (endpoint 与说明). However it never distinguishes itself from the sibling runninghub_list_models, which an agent could easily confuse with a search tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The tool-to-tool handoff is explicit — 找到模型后用 runninghub_submit_task 提交任务 — which is genuinely useful routing. But there is no guidance on when to use this versus runninghub_list_models, nor any exclusion conditions, so the core selection decision is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_submit_taskA
提交 RunningHub 标准模型任务。先用 runninghub_search_models 找到目标模型的 endpoint,再把该模型文档要求的参数放进 params。返回 taskId,可用 runninghub_wait_task 等待结果。注意:标准模型 API 需要企业级-共享 API Key。
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | 是否提交后自动轮询直到任务完成 | |
| params | No | 该模型 API 的请求参数对象(不含鉴权信息),如 {"prompt": "..."} | |
| endpoint | Yes | 模型 API 路径,如 "/openapi/v2/seedream-v5-pro/text-to-image" | |
| waitTimeoutSec | No | wait=true 时的最长等待秒数 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full burden, and it delivers the key non-obvious facts: the call returns a taskId (asynchronous), results must be awaited via runninghub_wait_task, and the standard model API requires an enterprise-shared API Key. It still omits failure/error semantics and any rate-limit or quota behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four compact sentences, front-loaded with the action, followed by workflow, return value, and the auth caveat. No sentence is redundant and nothing is buried.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter submission tool with no annotations and no output schema, the description covers the action, the required inputs' provenance, the return value, and the auth constraint. Minor gaps remain around error handling and what wait=true actually blocks on, which the schema only partially clarifies.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds real meaning: endpoint must come from runninghub_search_models, and params must contain exactly the fields the target model's documentation requires (and excludes auth info). That is guidance the schema alone does not provide.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb+resource ('提交 RunningHub 标准模型任务') and scopes it to 'standard model' tasks, which distinguishes it from sibling query/wait/file tools. An agent can tell what this does without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives an explicit ordered workflow: call runninghub_search_models first to obtain the endpoint, then populate params from that model's docs, then use runninghub_wait_task for results. Alternatives and prerequisites are named rather than implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_upload_fileA
上传本地文件(图片/视频/音频/压缩包)到 RunningHub,返回 fileName。工作流/AI 应用的图片、音频、视频节点参数请把该 fileName 填入 fieldValue。
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | 本地文件的绝对路径 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral burden. It usefully discloses the return value (fileName) and the downstream wiring into fieldValue, but says nothing about size/format limits, overwrite behavior, authentication needs, or failure modes for an upload (a write) operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tightly written sentences with no waste, front-loading the action and return value before the downstream integration hint. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool with no output schema and no annotations, the description covers what it does, what it returns, and how the result is consumed. It falls short of full completeness only on operational limits and error behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and there is only one parameter, so the schema already documents filePath as an absolute local path. The description adds only the broad category of accepted file types, which is marginal beyond the structured field, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (上传/upload) and resource (本地文件 - local image/video/audio/archive), and explicitly names the return value (fileName). It also distinguishes itself from the sibling runninghub_download_file by scoping to local-file-to-server direction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives clear usage context: upload first, then place the returned fileName into fieldValue for workflow/AI app image, audio, and video node parameters. However, it does not explicitly name alternatives (e.g., download_file) or state exclusions such as file-size or format limits.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
runninghub_wait_taskA
轮询等待 RunningHub 任务完成(每 5 秒查询一次,直到 SUCCESS / FAILED 或超时)。返回结果文件 URL 列表。
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | 任务 ID | |
| apiVersion | No | 查询接口版本:v2=标准模型 API 任务(/openapi/v2/query);legacy=工作流/AI应用任务(/task/openapi/outputs)。不确定时先试 v2,失败再用 legacy | v2 |
| timeoutSec | No | 最长等待秒数,默认 600 | |
| intervalSec | No | 轮询间隔秒数,默认 5 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does disclose useful traits: the polling cadence, the terminal states (SUCCESS/FAILED), the timeout bound, and the return shape (URL list). It omits what happens on timeout (error vs partial result) and any auth/quota requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences: the first front-loads the polling/wait behavior and termination conditions, the second states the return value. No filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description correctly supplies the return shape (list of result file URLs). Combined with 100% schema coverage and the disclosed polling/timeout behavior, an agent has what it needs; only timeout-failure semantics are missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the schema itself richly documents apiVersion (with endpoints and fallback advice), timeoutSec, and intervalSec. The description only echoes the 5-second interval, adding no meaning beyond the structured fields, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (poll/wait) and resource (RunningHub task) plus the completion condition. It implicitly separates itself from the single-shot runninghub_query_task by describing polling-until-terminal-state, though it never names that sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is only implied: an agent infers it should call this when it wants to block until completion. There is no explicit statement of when to prefer this over runninghub_query_task, and no exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
7 tool updates
v1.0.0- First observed
runninghub_download_file - First observed
runninghub_list_models - First observed
runninghub_query_task - First observed
runninghub_search_models - First observed
runninghub_submit_task - First observed
runninghub_upload_file - First observed
runninghub_wait_task
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: submit/query/wait tasks, upload/download files. However, search_models and list_models both retrieve the model catalog, and an agent may need to read descriptions carefully to choose between keyword search and category browsing. The overlap is minor but present.
All tool names follow the same predictable pattern: runninghub_ prefix plus verb_noun (search_models, list_models, submit_task, query_task, wait_task, upload_file, download_file). The snake_case convention is consistent throughout with no deviations.
Seven tools is a well-scoped set for an image generation service. Each tool covers a necessary step in the workflow: discovery, submission, monitoring, and file transfer. No tool feels redundant or excessive.
The surface covers the core lifecycle: finding models, submitting tasks, polling for results, and uploading/downloading files. Minor gaps exist, such as no explicit task cancellation and no tool to submit workflow/AI-app tasks despite query_task mentioning legacy support for them.
Maintenance
Related MCP Connectors
Generate images, video, music, voice and 3D through one API. 30 tools, 200+ models.
Image, video, audio, face-swap, talking avatars and chat across 300+ AI models, one balance.
Generate AI images and videos from 89 models on one credit balance, refunds on failure.
Generate and edit images, videos, and audio with 150+ models from 20+ vendors.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI image generation, editing, and composition using Google's Gemini image models (Nano Banana Pro and Nano Banana). Supports text-to-image generation, multi-image composition, flexible aspect ratios, high-resolution output up to 4K, and real-time information grounding.4-
- AlicenseNot gradedqualityBmaintenanceEnables AI-assisted image generation from text prompts using multiple providers (Tencent Hunyuan, OpenAI DALL-E 3, and Doubao) with support for various artistic styles, resolutions, and negative prompts through a unified interface.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables image generation and editing using laozhang.ai's OpenAI-compatible API, with tools for text-to-image and image-to-image transformations.MIT
- AlicenseNot gradedqualityDmaintenanceProvides 80+ image processing tools including AI generation, background removal, upscaling, local manipulation, and diagram rendering, all with built-in cost tracking and health monitoring.48 npmMIT