@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 客户端将其作为子进程启动，因此你在 shell 中导出的密钥无法到达它。这是最常见的设置失败原因，服务器会以解释退出，而不是在损坏状态下启动。

在 platform.dreamlayer.io 获取密钥。新账户从零积分开始，每张完成的图像消耗一个积分。

工具

操作

省略 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。