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 直接调用灵姬生成图片、视频、音频