Skip to main content
Glama
RunningHub MCP Server

RunningHub MCP Server

by tolatolatop

RunningHub MCP Server

基于 FastMCP 框架的 MCP 服务,为 RunningHub AI 应用平台提供完整的工具集。

功能概览

  • 节点查询 - 获取 AI 应用的可配置节点列表

  • 文件上传 - 上传图片/音频/视频到 RunningHub 平台

  • 任务提交 - 提交 AI 应用任务并获取 taskId

  • 结果查询 - 查询任务执行状态和输出结果

  • 一键执行 - 提交任务并自动轮询等待完成

  • 任务管理 - 基于本地 JSON 文件的任务持久化管理

Related MCP server: MCP Server for Replicate

安装

# 使用 uv(推荐)
cd runninghub-mcp
uv sync

# 或使用 pip
pip install -e .

配置

通过环境变量配置服务:

环境变量

必需

默认值

说明

RUNNINGHUB_API_KEY

是

-

RunningHub API 密钥

RUNNINGHUB_API_HOST

否

www.runninghub.cn

API 主机地址

RUNNINGHUB_TASK_STORE_PATH

否

~/.runninghub/tasks.json

任务持久化文件路径

MCP 客户端配置示例

Cursor / Claude Desktop (mcp.json)

{
  "mcpServers": {
    "runninghub": {
      "command": "uv",
      "args": ["--directory", "/path/to/runninghub-mcp", "run", "runninghub-mcp"],
      "env": {
        "RUNNINGHUB_API_KEY": "your-api-key"
      }
    }
  }
}

Tool 列表

原子工具(API 端点)

Tool

说明

关键参数

get_node_info

获取 AI 应用的可配置节点列表

webapp_id

upload_file

上传文件到 RunningHub

file_path

submit_task

提交 AI 应用任务

webapp_id, node_info_list

query_task_outputs

查询任务状态和输出结果

task_id

完整流程工具

Tool

说明

run_task_and_wait

提交任务并轮询等待完成,支持自定义超时和轮询间隔

持久化管理工具

Tool

说明

关键参数

list_tasks

查询本地存储的任务列表

status(可选), limit

get_task_detail

获取指定任务的详细信息

task_id

sync_task_status

从 API 同步任务最新状态到本地

task_id

使用流程

典型的使用流程如下:

  1. 调用 get_node_info 获取 AI 应用的节点列表

  2. 根据需要修改节点参数(如需上传文件,先调用 upload_file)

  3. 调用 run_task_and_wait 提交任务并等待结果(或分步使用 submit_task + query_task_outputs)

  4. 使用 list_tasks / get_task_detail 查看历史任务

项目结构

src/runninghub_mcp/
  __init__.py     # 包入口
  server.py       # FastMCP 服务实例 + Tool 定义 + 入口
  api.py          # RunningHub HTTP API 封装
  storage.py      # 任务持久化管理(JSON 文件)
  models.py       # 数据模型定义

开发

# 安装开发依赖
uv sync

# 直接运行服务(STDIO 模式)
RUNNINGHUB_API_KEY=your-key uv run runninghub-mcp

# 使用 fastmcp dev 调试
RUNNINGHUB_API_KEY=your-key uv run fastmcp dev src/runninghub_mcp/server.py

Available Tools

8 tools
get_node_infoA

Get the configurable node list of an AI application. Returns all modifiable node info (nodeId, fieldName, fieldType, fieldValue).

Inputs: webapp_id (required). Returns: result

get_task_detailB

Get detailed information of a specific task from local persistent storage.

Inputs: task_id (required). Returns: object

list_tasksA

List tasks from local persistent storage. Supports filtering by status (pending/queued/running/completed/failed). Results are sorted by last update time in descending order.

Inputs: status, limit. Returns: result

query_task_outputsA

Query the execution status and output of a task. Status codes: 0=completed, 804=running, 813=queued, 805=failed. Returns output file URLs when completed.

Inputs: task_id (required). Returns: object

run_task_and_waitA

Submit an AI application task and wait for completion (auto-polling). Combines submit_task + query_task_outputs into a full workflow. Default max wait is 10 minutes with 5-second polling interval. Task status is automatically synced to persistent storage.

Inputs: webapp_id (required), node_info_list (required), timeout, poll_interval. Returns: object

submit_taskA

Submit an AI application task. Requires webapp_id and node_info_list. Returns taskId for subsequent status queries. The task is automatically saved to local persistent storage.

Inputs: webapp_id (required), node_info_list (required). Returns: object

sync_task_statusA

Sync task status from RunningHub API to local persistent storage. Useful for refreshing status of previously timed-out tasks.

Inputs: task_id (required). Returns: object

upload_fileA

Upload a local file to RunningHub platform. Supports IMAGE, AUDIO, VIDEO types. Returns the uploaded fileName for use in node fieldValue.

Inputs: file_path (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation3/5

    There is overlap between submit_task and run_task_and_wait (both submit tasks), and between query_task_outputs and run_task_and_wait (both check status/output). However, descriptions clarify the combination pattern in run_task_and_wait, so ambiguity is limited but still present.

    Naming Consistency4/5

    Most tools follow a consistent snake_case verb_noun pattern (e.g., get_node_info, submit_task). The exception is run_task_and_wait, which deviates with 'and_wait', and 'list_tasks' vs 'query_task_outputs' use different verbs for similar operations.

    Tool Count5/5

    8 tools is well-scoped for an AI task runner, covering submission, synchronization, file upload, and status queries without being excessive or minimal.

    Completeness4/5

    Core workflow (submit/run, query output, sync status, upload files) is covered. Missing tools for listing available applications or canceling tasks, but these are not critical for the primary use case.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A FastMCP server implementation that facilitates resource-based access to AI model inference, focusing on image generation through the Replicate API, with features like real-time updates, webhook integration, and secure API key management.
      18
      44 PyPI
      16
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents and LLMs to interact with the ICON MCP v104 API through standardized tools. The server is built on FastMCP for efficient async handling and includes Docker support for easy deployment.
      -
    • F
      license
      C
      quality
      D
      maintenance
      A FastMCP-based server that enables uploading text and base64-encoded content to MinIO object storage through an HTTP transport. It supports automated bucket management and secure file path generation to streamline remote storage operations.
      -