MCP Integration

Laissez l'agent IA appeler Lingie directement
Générer des images, des vidéos et de l'audio

Le serveur MCP officiel de Lingie (Lingie.Mcp) encapsule les capacités de génération du client en outils MCP standard : tout agent IA compatible MCP, comme Claude Desktop, Cursor, ZCode, peut s'y connecter en un clic. Écrivez votre prompt, laissez le reste à l'agent.

Pourquoi utiliser Lingie MCP

Zéro dépendance, un seul fichier

Implémentation monofichier en Node.js pur (≥18), aucun npm install requis, clonez et utilisez.

Couverture locale + cloud

Workflows ComfyUI locaux gratuits, ou accès via passerelle aux GPU cloud et aux modèles tiers comme DALL·E, Midjourney, Kling.

Résultats conservés pour les tâches longues

Si la tâche n'est pas terminée après environ 20 s, un identifiant de tâche est renvoyé automatiquement ; l'agent le récupère par polling, sans subir le délai d'expiration de 30 secondes de l'hôte.

Intégration sans aucune modification

Réutilisez directement l'API locale intégrée de Lingie. Les identifiants de passerelle sont émis en un clic dans les paramètres Lingie et prennent effet automatiquement en environ 10 secondes.

Démarrage rapide

Intégration en trois étapes : clonez le dépôt, copiez la configuration, redémarrez l'agent, et les outils lingie apparaissent.

1. Prérequis

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

2. Cloner le dépôt

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

3. Configurer l'agent

Ajoutez dans le fichier de configuration MCP de ZCode / Claude Desktop / Cursor (remplacez le chemin par votre répertoire de clonage réel) :

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

Liste des outils

Expose par défaut l'outil « Workflow API » (moteur ComfyUI local, gratuit) :

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

Lorsque les identifiants de passerelle sont disponibles (Lingie Paramètres → API locale → activer « Accès passerelle Agent (MCP) », ou définir des variables d'environnement), des outils de passerelle supplémentaires sont exposés, couvrant ComfyUI local/cloud et les modèles tiers (facturés en crédits 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查询灵力值余额(可用 = 余额 − 冻结)

Le port, le token, le répertoire de sortie, les journaux, etc. peuvent être remplacés par des variables d'environnement ; voir le README du dépôt. Une fois l'accès passerelle activé côté Lingie, les identifiants sont automatiquement écrits dans mcp-credentials.json local, sans configuration manuelle.

Processus d'appel typique de l'agent

Prenons « texte vers image » : une génération complète ne nécessite que 6 étapes :

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

Prêt à laisser l'agent agir à votre placeCréation?

Clonez Lingie.Mcp : intégration en quelques minutes, génération entièrement via le client Lingie, facturation en points d'énergie transparente et maîtrisable.

LingieAI.com