灵姬 로고灵姬 LingieLingieAI.com

MCP Integration

AI Agent가 링지(Lingie)를 직접 호출
이미지, 비디오, 오디오 생성

링지 공식 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초 후 자동으로 적용됩니다.

빠른 시작

3단계 연동: 저장소 클론, 설정 복사, 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 설정

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

포트, 토큰, 출력 디렉토리, 로그 등은 모두 환경 변수로 덮어쓸 수 있습니다. 자세한 내용은 저장소 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