RunningHub MCP Server
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 MCP Server Run the AI task for webapp ID 1024 and wait for the results."
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 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 密钥 |
| 否 |
| API 主机地址 |
| 否 |
| 任务持久化文件路径 |
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 | 说明 | 关键参数 |
| 获取 AI 应用的可配置节点列表 |
|
| 上传文件到 RunningHub |
|
| 提交 AI 应用任务 |
|
| 查询任务状态和输出结果 |
|
完整流程工具
Tool | 说明 |
| 提交任务并轮询等待完成,支持自定义超时和轮询间隔 |
持久化管理工具
Tool | 说明 | 关键参数 |
| 查询本地存储的任务列表 |
|
| 获取指定任务的详细信息 |
|
| 从 API 同步任务最新状态到本地 |
|
使用流程
典型的使用流程如下:
调用
get_node_info获取 AI 应用的节点列表根据需要修改节点参数(如需上传文件,先调用
upload_file)调用
run_task_and_wait提交任务并等待结果(或分步使用submit_task+query_task_outputs)使用
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.pyAvailable Tools
8 toolsget_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
Scored across 8 tools
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.
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.
8 tools is well-scoped for an AI task runner, covering submission, synchronization, file upload, and status queries without being excessive or minimal.
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
Related MCP Connectors
Adaptive running coach MCP server — training data, plans, and recovery for AI assistants.
Remote MCP server for AIStoryHub: stories, chapters, story bible, Voiceprints, AI generation.
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
Related MCP Servers
- AlicenseCqualityDmaintenanceA 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.1844 PyPI16MIT
- AlicenseNot gradedqualityDmaintenanceA FastMCP server implementation that provides a standardized interface for accessing AI models hosted on Replicate's API, currently supporting image generation with customizable parameters.3MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseCqualityDmaintenanceA 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.-