huajing-mcp

画境（产品代码 huajing）MCP stdio 服务，供 Cursor / jrjb 生态智能体调用素材入库与异步 AI 能力。

本进程通过 stdio 通信，将工具调用转发至 imagehub-core-server 的 /internal/mcp/v1/*。waitAiTask 在本进程轮询任务状态。

前置条件

1. 已启动 imagehub-core-server（本地 dev 端口 4402）
2. Node.js 18+
3. 在主站个人中心签发个人空间 Agent API Key（bigapp_…）

安装与构建

cd huajing-mcp
npm install
npm run build              # development → 127.0.0.1:4402
npm run build:test
npm run build:production

环境变量

| 变量 | 说明 | 必填 | |------|------|------| | BIGAPP_API_KEY | 个人空间 Agent 密钥 | 是 | | BIGAPP_API_BASE | 覆盖构建 bake 的 API 根地址 | 否 |

BIGAPP_API_BASE：直连 4402/4412/4422 不加 /api；公网域名自动补 /api。

工具清单

| Tool | 说明 | |------|------| | whoami | 身份与工作空间 | | listImages / getImage | 素材列表/元数据 | | importImageFromUrl / uploadImage | URL 或本地/base64 入库 | | createAiMatting / Upscale / Remove / Generate / Expand / Redraw | 创建异步 AI 任务 | | getAiTask / cancelAiTask / waitAiTask | 查询 / 取消 / 轮询 | | listProjects / getProject / saveProject / deleteProject | 工作稿 |

推荐链路： whoami → 入库 → createAi* → waitAiTask → 使用 outputPublicUrl。

设计文档：../docs/huajing-mcp-design.md

Cursor 接入

见 cursor-mcp.example.json。