RHMCP

🚀 RHMCP - RunningHub AI Platform MCP Server - 让 AI Agent 调用生图、视频生成、音频处理等功能。

文档导航

客户端	文档
OpenCode	配置指南
OpenClaw	配置指南
OpenClaw Skill	Skill 指南
Claude Desktop	参考 OpenCode 配置
常见问题	FAQ

安装使用

⚠️ 重要说明：npm 包 runninghub-mcp 暂时不可用。请使用以下 GitHub 安装方式。

推荐方式：GitHub 直接安装

# 全局安装（推荐）
npm install -g AIRix315/RHMCP

# 验证安装
rhmcp --help

方式二：克隆仓库本地构建

# 克隆仓库
git clone https://github.com/AIRix315/RHMCP.git
cd RHMCP

# 安装依赖
npm ci

# 构建
npm run build

# 全局链接
npm link

方式三：指定版本安装

# 从 GitHub Release 安装
npm install -g AIRix315/RHMCP#v1.1.1

配置步骤

# 1. 创建配置目录
mkdir -p ~/.rhmcp

# 2. 设置 API Key（从 https://www.runninghub.cn 获取）
echo "RUNNINGHUB_API_KEY=your_api_key_here" > ~/.rhmcp/.env

# 3. 创建 service.json
cat > ~/.rhmcp/service.json << 'EOF'
{
  "baseUrl": "auto",
  "maxConcurrent": 1,
  "storage": { "mode": "none" }
}
EOF

# 4. 创建 apps.json（运行更新命令获取官方 APP 列表）
rhmcp --update-apps ~/.rhmcp/apps.json

baseUrl 说明：

"auto"：自动检测账号区域

"www.runninghub.cn"：国内站

"www.runninghub.ai"：国际站

MCP 客户端配置

OpenCode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "rhmcp": {
      "type": "local",
      "command": ["rhmcp", "--stdio"],
      "environment": {
        "RHMCP_CONFIG": "/home/user/.rhmcp"
      }
    }
  }
}

Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "rhmcp": {
      "command": "rhmcp",
      "args": ["--stdio"],
      "env": {
        "RHMCP_CONFIG": "/home/user/.rhmcp"
      }
    }
  }
}

OpenClaw Skill

如果你使用 OpenClaw，可以启用内置的 Skill 包装层，获得更友好的 Agent 指引：

安装 Skill

在 OpenClaw 配置中添加 Skill 路径：

{
  "mcp": {
    "servers": {
      "rhmcp": {
        "command": "node",
        "args": ["E:/Projects/RHMCP/dist/server/index.js", "--stdio"],
        "env": {
          "RHMCP_CONFIG": "E:/Projects/RHMCP"
        }
      }
    }
  },
  "skills": {
    "entries": {
      "rhmcp-skill": {
        "enabled": true,
        "path": "E:/Projects/RHMCP/skills/openclaw"
      }
    }
  }
}

Skill 特性

特性	说明
场景映射	用户说"生成图片" → 自动选择 `qwen-text-to-image`
参数填充	自动填充默认参数（width: 1024, height: 1024）
存储决策	AUTO 模式智能选择最佳存储方式
链式工作流	URL 自动传递，支持多步骤任务
错误处理	友好提示 + 自动重试策略

详细配置请参考 **skills/openclaw/README.md**。

开发指南

如需修改源码：

git clone https://github.com/AIRix315/RHMCP.git
cd RHMCP
npm install
npm run build

# 开发模式
npm run dev        # HTTP 模式
npm run dev:stdio  # STDIO 模式

# 测试
npm test

可用工具

工具	用途
`rh_upload_media`	上传图片/视频/音频
`rh_get_app_info`	获取 APP 参数配置
`rh_execute_app`	执行 APP 生成内容
`rh_query_task`	查询任务状态
`rh_add_app`	添加自定义 APP
`rh_remove_app`	移除 APP
`rh_update_rules`	更新模型规则
`rh_list_rules`	列出可用规则

配置要点

配置项	说明
baseUrl	`auto`（自动检测）、`www.runninghub.cn`（国内站）、`www.runninghub.ai`（国际站）
API Key	从 RunningHub 控制台获取
环境变量	`RHMCP_CONFIG` 指向配置目录

许可证

MIT License