灵姬 Logo灵姬 LingieLingieAI.com

MCP Integration

Cho AI Agent gọi trực tiếp Linh Cơ
Tạo hình ảnh, video, âm thanh

Máy chủ MCP chính thức của Linh Cơ (Lingie.Mcp) đóng gói khả năng tạo sinh của máy khách thành công cụ MCP tiêu chuẩn, bất kỳ AI Agent nào hỗ trợ MCP như Claude Desktop, Cursor, ZCode đều có thể tích hợp một chạm: viết prompt, phần còn lại giao cho Agent.

Xem kho GitHub ↗Tải ứng dụng miễn phí

Tại sao dùng Linh Cơ MCP

Tệp đơn không phụ thuộc

Triển khai tệp đơn thuần Node.js (≥18), không cần npm install, nhân bản là dùng được.

Bao phủ đầy đủ cục bộ + đám mây

Workflow ComfyUI cục bộ miễn phí, hoặc gọi GPU đám mây và các mô hình bên thứ ba như DALL·E, Midjourney, Kling qua cổng.

Tác vụ dài không mất kết quả

Sau khoảng 20 giây chưa hoàn thành sẽ tự động hạ cấp trả về task id, Agent truy vấn lấy lại, không bị giới hạn thời gian chờ 30 giây của máy chủ.

Tích hợp không thay đổi

Tái sử dụng trực tiếp API nội bộ của Lingie, thông tin xác thực cổng được cấp một chạm trong cài đặt Lingie, có hiệu lực tự động sau khoảng 10 giây.

Bắt đầu nhanh

Tích hợp ba bước: nhân bản kho lưu trữ, sao chép cấu hình, khởi động lại Agent là có thể thấy công cụ lingie.

1. Điều kiện tiên quyết

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

2. Nhân bản kho lưu trữ

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

3. Cấu hình Agent

Thêm vào tệp cấu hình MCP của ZCode / Claude Desktop / Cursor (thay đường dẫn bằng thư mục clone thực tế của bạn):

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

Danh sách công cụ

Mặc định hiển thị công cụ «API quy trình làm việc» (engine ComfyUI cục bộ, miễn phí):

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取消任务（会中断本地引擎当前正在执行的任务）

Khi thông tin xác thực cổng khả dụng (Lingie → Cài đặt → API cục bộ → bật «Kết nối cổng Agent (MCP)», hoặc đặt biến môi trường), các công cụ cổng bổ sung sẽ được hiển thị, bao phủ ComfyUI cục bộ/đám mây và mô hình bên thứ ba (tính phí theo năng lượng):

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查询灵力值余额（可用 = 余额 − 冻结）

Cổng, Token, thư mục đầu ra, nhật ký... đều có thể ghi đè qua biến môi trường, xem README trong kho lưu trữ. Sau khi bật cổng kết nối ở phía Lingie, thông tin xác thực tự động ghi vào mcp-credentials.json trên máy, không cần cấu hình thủ công.

Quy trình gọi điển hình của Agent

Lấy «Văn bản tạo ảnh» làm ví dụ, một lần tạo hoàn chỉnh chỉ cần 6 bước:

1lingie_health
确认灵姬在线（引擎未运行也可提交，会自拉起）
2lingie_list_workflows
找到想用的工作流（如「文生图」）
3lingie_workflow_capabilities
了解参数怎么填
4lingie_upload_file（可选）
图生图先上传参考图
5lingie_run_workflow
提交生成：约 20 秒内完成直接拿到输出文件本地路径，否则拿到 run_id 走下一步
6lingie_run_result
轮询 run_id，完成时返回输出文件本地路径，Agent 直接处理

Sẵn sàng để Agent thay bạnSáng tạoRồi chứ?

Nhân bản Lingie.Mcp, hoàn tất tích hợp trong vài phút, toàn bộ quá trình chạy qua ứng dụng Lingie, phí năng lượng minh bạch và kiểm soát được.

Đến GitHubTải Lingie trước

LingieAI.com