MCP Integration

讓 AI Agent 直接呼叫靈姬
生成圖片、影片、音訊

靈姬官方 MCP 伺服器（Lingie.Mcp）將客戶端的生成能力封裝為標準 MCP 工具，Claude Desktop、Cursor、ZCode 等任何支援 MCP 的 AI Agent 都能一鍵接入：寫好提示詞，剩下的交給 Agent。

查看 GitHub 倉庫 ↗免費下載客戶端

為什麼用靈姬 MCP

零依賴單檔案

純 Node.js（≥18）單檔案實作，無需 npm install，克隆即用。

本地 + 雲端全覆蓋

免費本地 ComfyUI 工作流程，或經閘道呼叫雲端 GPU 與 DALL·E、Midjourney、Kling 等第三方模型。

長任務不遺失結果

約 20 秒未完成自動降級返回任務 id，Agent 輪詢取回，不受宿主 30 秒呼叫逾時限制。

零改動接入

直接重用靈姬內建本地 API，閘道憑證在靈姬設定中一鍵簽發，約 10 秒自動生效。

快速開始

三步接入：克隆倉庫、複製設定、重啟 Agent 即可看到 lingie 工具。

1. 前置條件

1灵姬客户端正在运行（官网免费下载）
2灵姬设置 → 本地 API → 开启「外部工作流 API」（端口默认 17856）
3无需手动启动 ComfyUI 引擎：提交任务时灵姬会自动拉起（首次约 30-120 秒）

2. 克隆倉庫

git clone https://github.com/MechaBabyAi/Lingie.Mcp.git C:\MCP\Lingie.Mcp

GitHub ↗

3. 設定 Agent

在 ZCode / Claude Desktop / Cursor 的 MCP 設定檔中加入（路徑替換為你的實際克隆目錄）：

{
  "mcpServers": {
    "lingie": {
      "command": "node",
      "args": ["C:\\MCP\\Lingie.Mcp\\server.mjs"]
    }
  }
}

工具清單

預設暴露「工作流 API」工具（本地 ComfyUI 引擎，免費）：

lingie_health检查灵姬本地 API 与本地 ComfyUI 引擎是否在线（未运行时提交会自动拉起）

lingie_list_workflows列出可用工作流（图片/视频/音频生成等）

lingie_workflow_capabilities查看某工作流的参数模式（类型/必填/默认值/可选值/提交方式）

lingie_upload_file上传本地文件到 ComfyUI 输入目录（供图生图/参考图/首帧等参数使用）

lingie_run_workflow执行工作流：完成直接返回输出文件本地路径，超过约 20 秒自动降级返回 run_id

lingie_run_result轮询 run_id 并取回结果，完成时返回输出文件本地路径

lingie_run_status查询任务状态与进度（不下载输出）

lingie_cancel_run取消任务（会中断本地引擎当前正在执行的任务）

當閘道憑證可用時（靈姬設定 → 本地 API → 開啟「Agent (MCP) 閘道接入」，或設定環境變數），額外暴露閘道工具，涵蓋本地/雲端 ComfyUI 與第三方模型（按靈力值計費）：

lingie_list_models列出网关可用模型（本地/云端 ComfyUI 与第三方模型）

lingie_generate_image一键调用模型生成图片（超时自动降级返回 task_id）

lingie_generate_video一键调用模型生成视频（超时自动降级返回 task_id）

lingie_task_status查询网关任务状态与输出

lingie_cancel_task取消网关任务

lingie_estimate_cost预估一次模型调用的灵力值消耗（不实际生成）

lingie_spirit_balance查询灵力值余额（可用 = 余额 − 冻结）

連接埠、Token、輸出目錄、日誌等均可透過環境變數覆寫，詳見倉庫 README。靈姬端開啟閘道接入後憑證自動寫入本機 mcp-credentials.json，無需手動設定。

Agent 典型呼叫流程

以「文生圖」為例，一次完整的生成只需 6 步：

1lingie_health

确认灵姬在线（引擎未运行也可提交，会自拉起）

2lingie_list_workflows

找到想用的工作流（如「文生图」）

3lingie_workflow_capabilities

了解参数怎么填

4lingie_upload_file（可选）

图生图先上传参考图

5lingie_run_workflow

提交生成：约 20 秒内完成直接拿到输出文件本地路径，否则拿到 run_id 走下一步

6lingie_run_result

轮询 run_id，完成时返回输出文件本地路径，Agent 直接处理

準備好讓 Agent 替你創作了嗎？

複製 Lingie.Mcp，幾分鐘完成接入，生成全程走靈姬客戶端，靈力值計費透明可控。

前往 GitHub 先下載靈姬

LingieAI.com

讓 AI Agent 直接呼叫靈姬生成圖片、影片、音訊