MCP Integration

ให้ AI Agent เรียกใช้灵姬 โดยตรง
สร้างรูปภาพ วิดีโอ เสียง

MCP server ทางการของ灵姬 (Lingie.Mcp) ห่อหุ้มความสามารถในการสร้างของฝั่ง client เป็นเครื่องมือ MCP มาตรฐาน Claude Desktop, Cursor, ZCode หรือ AI Agent ใดๆ ที่รองรับ MCP ก็เชื่อมต่อได้ในคลิกเดียว: เขียน prompt ให้ดี ที่เหลือปล่อยให้ Agent จัดการ

ทำไมต้องใช้灵姬 MCP

ไฟล์เดียว ไม่มี dependencies

ใช้ Node.js บริสุทธิ์ (≥18) ไฟล์เดียว ไม่ต้อง npm install โคลนแล้วใช้ได้เลย

ครอบคลุมทั้ง Local และคลาวด์

ComfyUI workflow ฟรีในเครื่อง หรือเรียก GPU คลาวด์และโมเดล第三方 เช่น DALL·E, Midjourney, Kling ผ่าน网关

งานยาวไม่สูญเสียผลลัพธ์

ถ้าไม่เสร็จในประมาณ 20 วินาที จะลดระดับอัตโนมัติและส่งคืน task id ให้ Agent Polling เรียกคืน ไม่ถูกจำกัดด้วย 30 วินาที timeout ของโฮสต์

เชื่อมต่อโดยไม่ต้องแก้ไข

ใช้ API ภายในของ Lingie โดยตรง ใบรับรองเกตเวย์ออกให้ด้วยคลิกเดียวในการตั้งค่า Lingie มีผลอัตโนมัติในประมาณ 10 วินาที

เริ่มต้นอย่างรวดเร็ว

เชื่อมต่อในสามขั้นตอน: โคลน仓库 คัดลอกการกำหนดค่า รีสตาร์ท Agent ก็จะเห็นเครื่องมือ lingie

1. ข้อกำหนดเบื้องต้น

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

2. โคลน仓库

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

3. กำหนดค่า Agent

เพิ่มในไฟล์กำหนดค่า MCP ของ ZCode / Claude Desktop / Cursor (แทนที่พาธด้วยไดเรกทอรีที่คุณโคลนจริง):

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

รายการเครื่องมือ

เปิดเผยเครื่องมือ "Workflow 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取消任务(会中断本地引擎当前正在执行的任务)

เมื่อข้อมูลรับรองเกตเวย์พร้อมใช้งาน (Lingie → การตั้งค่า → Local API → เปิด "Agent (MCP) Gateway Access" หรือตั้งค่าตัวแปรสภาพแวดล้อม) จะเปิดเผยเครื่องมือเกตเวย์เพิ่มเติม ครอบคลุม ComfyUI ในเครื่อง/คลาวด์และโมเดลของบุคคลที่สาม (คิดค่าบริการตามพลัง Lingie):

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 ของ仓库 หลังจากเปิดการเชื่อมต่อเกตเวย์ฝั่ง Lingie ข้อมูลรับรองจะถูกเขียนลงใน 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 เชื่อมต่อได้ภายในไม่กี่นาที การสร้างทั้งหมดผ่านไคลเอนต์ Lingie ค่าพลังงานคิดโปร่งใสและควบคุมได้

LingieAI.com