RunningHub Image Gen MCP Plugin
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 Image Gen MCP Plugin Generate an image of a futuristic city at sunset"
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 Image Gen MCP Plugin
A Codex MCP plugin for generating images via RunningHub's seedream-v5-lite model.
Prerequisites
Python >= 3.11
uv package manager
A RunningHub API key (set as
RUNNINGHUB_API_KEY)
Related MCP server: seedream-mcp
Install
cd work/runninghub-image-gen
uv syncUsage
Environment variable
export RUNNINGHUB_API_KEY=your-api-key-hereTools
Tool | Description |
| Submit a text-to-image task, returns taskId |
| Poll task status/results by taskId |
| Submit + poll until complete |
Available parameters
prompt(required) — Text description of the imagewidth/height— Image dimensions in pixelsmax_images— Number of images to generatesequential_image_generation— "enabled" or "disabled"tools_type— e.g. "web_search"
Running standalone
RUNNINGHUB_API_KEY=your-key uv run runninghub-image-genAPI
Submit:
POST /openapi/v2/seedream-v5-lite/text-to-imageQuery:
POST /openapi/v2/query
Available Tools
3 toolsquery_taskA
Query the status and results of a previously submitted task. Use the taskId returned by text_to_image. Status values: QUEUED (waiting), RUNNING (processing), SUCCESS (completed, results available), FAILED (error occurred). When SUCCESS, results contains image URLs in the 'url' field.
Inputs: task_id (required). Returns: object
run_text_to_imageA
Submit a text-to-image task and poll until completion. Combines text_to_image + query_task polling into one call. Returns immediately with image URLs when SUCCESS, or status details if FAILED or TIMEOUT. Default timeout is 10 minutes.
Inputs: prompt (required), width, height, timeout, +4 more. Returns: object
text_to_imageA
Submit a text-to-image generation task to RunningHub (seedream-v5-lite). Returns a taskId that can be used with query_task to get results. Images are submitted asynchronously; use query_task to poll for completion.
Inputs: prompt (required), width, height, max_images, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The tools have clear descriptions but overlap: text_to_image and run_text_to_image both submit tasks, with run_text_to_image combining submission and polling. An agent might be uncertain which to use, though the descriptions help distinguish asynchronous vs synchronous workflows.
Naming is mixed: 'query_task' and 'run_text_to_image' follow a verb_noun pattern, but 'text_to_image' lacks a verb and reads as a noun phrase. The patterns are inconsistent, reducing predictability.
Three tools is minimal but reasonable for a focused plugin covering async submission, polling, and a combined sync call. It is slightly under the typical range but not problematic.
Covers the core workflow of submitting and retrieving image generation tasks, but lacks obvious operations like canceling tasks or listing all tasks. This leaves notable gaps for a full lifecycle.
Maintenance
Related MCP Connectors
Generate images, videos and music with model discovery, cost estimates and asynchronous results.
Create images and videos from prompts, with options for image mixing, reference images, and start/…
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate and edit images, create videos, quote credit costs, and retrieve private results.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI-powered image and video generation through the TensorsLab API using models like SeeDream and SeeDance. It supports tasks such as creating high-resolution media from text prompts, image-to-video conversion, and monitoring generation status.9MIT
- AlicenseAqualityBmaintenanceEnables creating, polling, and checking pricing for Seedream image generation tasks (edit and text-to-image) through a single RunAPI API key.692 npmApache 2.0
- AlicenseAqualityBmaintenanceEnables creating and managing GPT Image tasks (edit and text-to-image) via RunAPI, with options to poll status and check pricing.5136 npmApache 2.0
- AlicenseBqualityBmaintenanceEnables AI image and video generation tasks (text-to-image, image-to-video, edit, upscale, etc.) via RunAPI, with support for polling and pricing lookups.1084 npm1Apache 2.0