@dreamlayer/mcp

MCP 호환 AI 클라이언트를 위한 이미지 생성 및 편집 도구로, DreamLayer Agent API를 기반으로 합니다.

클론할 것도, 빌드할 것도 없습니다.

설치

클라이언트에 추가하세요. Claude Code:

claude mcp add dreamlayer --env DREAMLAYER_API_KEY=dlr_live_your_key -- npx -y @dreamlayer/mcp

Codex:

codex mcp add dreamlayer --env DREAMLAYER_API_KEY=dlr_live_your_key -- npx -y @dreamlayer/mcp

Cursor 또는 기타 stdio MCP 클라이언트:

{
  "mcpServers": {
    "dreamlayer": {
      "command": "npx",
      "args": ["-y", "@dreamlayer/mcp"],
      "env": { "DREAMLAYER_API_KEY": "dlr_live_your_key" }
    }
  }
}

키는 서버 자체 환경에 있어야 합니다. MCP 클라이언트는 이 서버를 하위 프로세스로 실행하므로, 셸에서 내보낸 키는 서버에 도달하지 않습니다. 이것이 가장 흔한 설정 실패이며, 서버는 손상된 상태로 시작하는 대신 설명과 함께 종료됩니다.

키는 platform.dreamlayer.io에서 받으세요. 새 계정은 0크레딧으로 시작하며, 완성된 이미지 하나당 1크레딧이 소요됩니다.

도구

작업

operation을 생략하면 DreamLayer가 프롬프트를 읽고, 명확화 질문을 반환할 수 있습니다. 이름을 지정하면 해당 추론은 완전히 건너뜁니다.

upscale은 각 변을 두 배로 늘리며 완성된 이미지는 변당 4096으로 제한되므로, 입력의 가장 긴 변은 2048 이하여야 합니다. 더 큰 이미지는 크레딧을 소모하기 전에 거부됩니다.

알아두면 좋은 동작

질문은 실패가 아닙니다. 모호한 프롬프트는 needs_input으로 끝나는 question 이벤트를 반환합니다. respond와 conversation_id를 사용하여 dreamlayer_generate를 다시 호출해 답하세요.

키를 재사용하면 재시도가 안전합니다. idempotency_key가 자동 생성됩니다. 불확실한 응답 후 재시도할 때 동일한 키를 다시 전달하면 원래 결과가 재생되어 두 번 지불하지 않습니다.

긴 실행은 잘리지 않고 유지됩니다. 256개 이상의 이벤트가 있는 스트림은 현재까지의 내용을 반환하고 truncated로 표시하며, 재개할 execution_id와 마지막 이벤트 ID를 제공합니다.

요구 사항

Node.js 22.12 이상.

라이선스

MIT. LICENSE 및 NOTICE를 참조하세요.