MCP 服务器

Independent Video Generator

Enables video generation through ComfyUI workflows, providing tools to list workflows, create and manage video jobs, upload assets, and retrieve results.

README

Independent Video Generator

這是從主專案抽離的獨立影片生成前端與後端，只保留 ComfyUI 影片 workflow，不包含 Agent 對話與圖像生成。

啟動

複製 .env.example 為 .env，確認 ComfyUI 與 FFPROBE 路徑。
安裝依賴：npm install
開發模式：npm run dev
正式建置：npm run build
正式啟動：npm run start

預設網址：http://127.0.0.1:8834

Windows 使用者可以直接雙擊 start.bat，它會自動切換到目前資料夾、建立 .env、安裝依賴並啟動服務。

影片 API

GET /api/video/workflows
POST /api/video/jobs
GET /api/video/jobs/:jobId
DELETE /api/video/jobs/:jobId

MCP 最小版本

先啟動影片 API，再執行 npm run mcp。MCP server 使用 stdio transport，透過 MCP_API_URL（預設 http://127.0.0.1:8834）呼叫既有影片 API。

提供的 tools：

list_video_workflows
create_video_job
upload_video_asset
get_video_job
list_video_jobs
get_video_result
cancel_video_job

Remote frontend and GPU host

Keep the frontend and MCP on the portable control side, and keep Backend, ComfyUI, models, and GPU on the same GPU host. Build the frontend with:

VITE_BACKEND_URL=http://GPU_HOST:8834

Configure the GPU host Backend with:

HOST=0.0.0.0
PORT=8834
COMFYUI_URL=http://127.0.0.1:8188
CORS_ORIGIN=http://FRONTEND_HOST

Configure MCP with:

MCP_API_URL=http://GPU_HOST:8834

The browser and MCP call only the Video Generator API; ComfyUI remains private on the GPU host. API key authentication is not enabled yet, so HOST=0.0.0.0 should only be used on a trusted LAN or VPN.

目前圖片與音訊仍使用 data URL 傳送，適合本機 MVP，不適合大型或多使用者部署。

影片 workflow 資產位於 workflow/。此專案目前與主專案共用相同的 ComfyUI 服務，但程式碼、前端頁面、任務 API 與 workflow JSON 已獨立。