Skip to main content
Glama
RunningHub Image Gen MCP Plugin

RunningHub Image Gen MCP Plugin

by ysbzc2022

# 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 sync

Usage

Environment variable

export RUNNINGHUB_API_KEY=your-api-key-here

Tools

Tool

Description

text_to_image

Submit a text-to-image task, returns taskId

query_task

Poll task status/results by taskId

run_text_to_image

Submit + poll until complete

Available parameters

  • prompt (required) — Text description of the image

  • width / height — Image dimensions in pixels

  • max_images — Number of images to generate

  • sequential_image_generation — "enabled" or "disabled"

  • tools_type — e.g. "web_search"

Running standalone

RUNNINGHUB_API_KEY=your-key uv run runninghub-image-gen

API

  • Submit: POST /openapi/v2/seedream-v5-lite/text-to-image

  • Query: POST /openapi/v2/query

Available Tools

3 tools
query_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

    A3.9/5.0

    Scored across 3 tools

    Disambiguation3/5

    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 Consistency2/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers