Luw.ai

Luw.ai 官方 MCP 服务

AI 室内、室外和景观设计，照片级渲染、图像编辑、视频和 3D，
可在 ChatGPT、Claude、Cursor、VS Code、Windsurf、Codex 及任何其他 MCP 客户端中使用。

You:     Redesign ~/Desktop/living-room.jpg in Japandi style, give me 2 options.
Claude:  ⟶ luw_interior_design  ✓ 2 designs in 21s   [shows both images]
You:     Love the first one. Make the sofa green velvet, then turn it into a fly-through video.
Claude:  ⟶ luw_edit_image ⟶ luw_generate_video   ✓

快速开始

将 https://mcp.luw.ai/mcp 添加到客户端并登录 Luw.ai。 无需安装，也无需复制密钥：登录后会自动为你创建密钥。新账户可获得免费额度。若要断开连接，请在 API 页面删除该密钥。

claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope user

{
  "mcpServers": {
    "luw": { "url": "https://mcp.luw.ai/mcp" }
  }
}

{
  "servers": {
    "luw": { "type": "http", "url": "https://mcp.luw.ai/mcp" }
  }
}

{
  "mcpServers": {
    "luw": {
      "url": "https://mcp.luw.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_LUW_API_KEY" }
    }
  }
}

托管服务是无状态的，不会存储任何内容；每次请求时，你的密钥都会直接发送到 Luw.ai API。它无法读取你电脑上的文件，因此请提供图片 URL，或使用下方的本地配置。

本地：处理计算机上的文件

本地服务使用 npx 在你的计算机上运行，因此可以读取 ~/Desktop/room.jpg 这样的路径。它需要 Node.js 18+ 和来自 app.luw.ai/dashboard/api 的 API 密钥。

claude mcp add luw --scope user --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

claude plugin marketplace add Luvi-io/luw-mcp
claude plugin install luw@luw-ai

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

{
  "inputs": [{ "type": "promptString", "id": "luw_api_key", "description": "Luw.ai API key", "password": true }],
  "servers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "${input:luw_api_key}" }
    }
  }
}

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

codex mcp add luw --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

[mcp_servers.luw]
command = "npx"
args = ["-y", "@luw-ai/mcp"]
env = { LUW_API_KEY = "YOUR_LUW_API_KEY" }

gemini extensions install https://github.com/Luvi-io/luw-mcp

{
  "mcpServers": {
    "luw": {
      "command": "npx",
      "args": ["-y", "@luw-ai/mcp"],
      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
    }
  }
}

Windows：如果找不到 npx，请使用 "command": "cmd", "args": ["/c", "npx", "-y", "@luw-ai/mcp"]。

你可以提出的请求

• “将这间卧室（~/Downloads/bedroom.jpg）重新设计为世纪中叶现代风格，提供 3 种方案。”
• “这张房源照片拍的是一间空房。把它布置成温馨的斯堪的纳维亚风格客厅。”
• “将我的草图 plan-sketch.png 渲染成一栋日落时分的逼真现代别墅。”
• “把这间厨房的地板改成人字拼橡木地板。”（先分割地板区域，再替换材质）
• “移除房间里的所有家具。”
• “把这张椅子的照片放在阳光明媚的画廊中，以水磨石地面为背景，用于广告。”
• “把这个渲染图制作成无人机穿越视频。”
• “根据这 3 张照片为这把扶手椅制作一个 3D 模型。”
• “无缝蓝色泽列格瓷砖纹理，1024px。”
• “询问 ArchiGPT 如何改善这个平面图的风水。”

内置提示词会以斜杠命令或提示词模板的形式显示在客户端中：redesign_room、stage_empty_room、sketch_to_render、product_shot。

工具

每次生成都会使用你的 Luw.ai 积分。每个变体均按一次生成计费。

Luw Studio：编辑你的 3D 项目

Luw Studio 可在 3D 中设计建筑。借助 Studio 工具，你的助手可以直接编辑 Studio 项目：房间、墙壁、门窗、楼梯、屋顶、家具和饰面。每次编辑都会即时保存到项目中，打开该项目的 Studio 标签页会在几秒内显示更新。

• 托管版： 使用 https://mcp.luw.ai/studio 替代 /mcp（登录方式相同）。它包含所有托管工具和 Studio 工具。
• 本地版： 将 studio 添加到 LUW_TOOLSETS，例如 LUW_TOOLSETS=generate,archigpt,personas,projects,studio。

“在我的 Luw Studio 项目 Beach House 中，在客厅东侧添加一间 3×4 m 的卧室，带一扇窗户，并为其配备家具。”

场景工具是 Pascal 的开源 MCP 工具（MIT），运行在与 Luw Studio 相同的核心之上，并使用其目录（包含 Luw 自有的部件）和默认设置。它们不消耗点数。可以读取上一个 Luw Studio 保存的项目；若要在此处编辑，请先在 Studio 中打开一次。助手会首先读取 luw://studio/guide，即建筑指南。

资源

可附加到对话中的只读上下文。在 Claude Code 中，输入 @luw: 以选择资源；其他支持资源的客户端可将其作为附件提供。

工作原理

• 本地文件开箱即用。 任何图像参数都接受 https:// URL、本地路径（~/Desktop/room.jpg）或 data: URI。本地文件会作为临时文件上传到 Luw.ai 存储（12 小时后删除），并缓存在当前会话中，因此重复编辑时不会再次上传同一个文件。
• 你可以看到结果。 完成的图像会嵌入工具结果中，因此 Claude 和其他客户端会以内嵌形式显示这些图像。设置 LUW_OUTPUT_DIR 还可将每个结果保存到磁盘。
• 长任务不会超时。 调用最多等待 50 秒，并向能够显示进度的客户端持续传输进度。如果视频等任务耗时更长，工具会返回 processing_url，助手会通过 luw_get_result 获取结果，不会重复生成或重复付费。
• 绝不会重复扣费。 每个生成请求都带有 Idempotency-Key，因此如果网络错误导致重试，Luw.ai 会返回原任务，而不是再次收费。
• 自动处理蒙版。 luw_segment 会以 URL 形式返回蒙版，因此“更改地板”会变为分割 ⟶ 魔术棒，无需手动创建蒙版。
• 快速启动。 该软件包是一个无依赖的单文件捆绑包，因此 npx 只需下载一个约 0.9 MB 的软件包即可立即启动。

配置

自托管远程服务

同一软件包也提供托管的 Streamable HTTP 端点：

npx -y @luw-ai/mcp --http --port 8080 --host 0.0.0.0   # MCP at /mcp, health at /health

docker build -t luw-mcp . && docker run -p 8080:8080 luw-mcp

该服务是无状态的。每个请求都会在 Authorization: Bearer …、X-Luw-Api-Key 或 ?api_key= 中携带自己的密钥。设置 LUW_MCP_OAUTH_SECRET，还可以让客户端改为登录 Luw.ai（OAuth）；登录后会向客户端提供普通 API 密钥。该服务可直接部署到 Vercel（已包含 vercel.json），并且提供了供 Heroku 使用的 Procfile。部署和发布步骤请参阅 docs/maintainers.md。

开发

npm ci
npm test               # unit and protocol tests (no network)
npm run build          # bundles dist/cli.js
npm run inspector      # try every tool in the MCP Inspector
LUW_API_KEY=... npm run smoke            # live checks against the real API (free)
LUW_API_KEY=... npm run smoke -- --paid  # plus one real generation (1 credit)
npm run mcpb           # build/luw.mcpb, the Claude Desktop extension
node scripts/vendor-pascal.mjs ../luwstudio2  # rebuild vendor/: Pascal core + MCP as Luw Studio runs them

支持

• API 参考：luw-ai.gitbook.io/api
• 问题反馈：GitHub Issues
• 电子邮件：[email protected]

MIT © Luvi Technologies, Inc.