MCP Integration

AI Agent'lerin Lingie'yi doğrudan çağırmasını sağlayın
Görsel, video ve ses üretin

Lingie resmi MCP sunucusu (Lingie.Mcp), istemcinin üretim yeteneklerini standart MCP araçları olarak paketler; Claude Desktop, Cursor, ZCode gibi MCP destekleyen herhangi bir AI Agent tek tıkla bağlanabilir: prompt'u yazın, gerisini Agent'a bırakın.

Neden Lingie MCP?

Sıfır bağımlılık, tek dosya

Saf Node.js (≥18) tek dosya uygulaması, npm install gerektirmez, klonlayın ve kullanın.

Yerel + bulut tam kapsam

Ücretsiz yerel ComfyUI iş akışları veya ağ geçidi üzerinden bulut GPU'su ve DALL·E, Midjourney, Kling gibi üçüncü taraf modelleri çağırın.

Uzun görevlerde sonuç kaybolmaz

Yaklaşık 20 saniyede tamamlanmazsa otomatik olarak görev kimliği döner; Agent sonucu yoklayarak alır, host'un 30 saniyelik çağrı zaman aşımına takılmaz.

Sıfır değişiklikle entegrasyon

Lingie'nin yerleşik yerel API'sini doğrudan kullanın; ağ geçidi kimlik bilgileri Lingie ayarlarında tek tıkla verilir, yaklaşık 10 saniyede otomatik etkinleşir.

Hızlı Başlangıç

Üç adımda bağlanın: depoyu klonlayın, yapılandırmayı kopyalayın, Agent'ı yeniden başlatın; lingie araçlarını göreceksiniz.

1. Ön Koşullar

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

2. Depoyu Klonlayın

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

3. Agent'ı Yapılandırın

ZCode / Claude Desktop / Cursor MCP yapılandırma dosyasına ekleyin (yolu kendi klon dizininizle değiştirin):

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

Araç Listesi

Varsayılan olarak «İş Akışı API» aracı sunulur (yerel ComfyUI motoru, ücretsiz):

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

Ağ geçidi kimlik bilgileri mevcut olduğunda (Lingie Ayarlar → Yerel API → «Agent (MCP) Ağ Geçidi Erişimi»ni açın veya ortam değişkenlerini ayarlayın), ayrıca ağ geçidi araçları sunulur; yerel/bulut ComfyUI ve üçüncü taraf modelleri kapsar (güç puanına göre faturalandırılır):

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

Port, Token, çıktı dizini, günlükler vb. ortam değişkenleriyle geçersiz kılınabilir; ayrıntılar için depo README'sine bakın. Lingie tarafında ağ geçidi erişimi açıldığında kimlik bilgileri otomatik olarak yerel mcp-credentials.json dosyasına yazılır, manuel yapılandırma gerekmez.

Tipik Agent Çağrı Akışı

Örnek olarak «metinden görsel»: tam bir üretim yalnızca 6 adım sürer:

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

Agent'ın sizin için yapmasına hazır olunYaratOldu mu?

Lingie.Mcp'yi klonlayın, birkaç dakikada entegrasyonu tamamlayın; üretim süreci tamamen Lingie istemcisi üzerinden ilerler, güç puanı faturalandırması şeffaf ve kontrol edilebilir.

LingieAI.com