Luw.ai

Luw.ai 公式 MCP サーバー

ChatGPT、Claude、Cursor、VS Code、Windsurf、Codex など、あらゆる MCP クライアントで利用できる、
AI によるインテリア・エクステリア・ランドスケープデザイン、フォトリアルなレンダリング、画像編集、動画、3D。

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 クレジットを使用します。バリエーションは1回の生成ごとに課金されます。

Luw Studio：3D プロジェクトを編集

Luw Studio は建物を 3D で設計します。Studio のツールを使うと、アシスタントが Studio プロジェクトを直接編集できます。部屋、壁、ドアや窓、階段、屋根、家具、仕上げを編集できます。編集内容はその都度プロジェクトに保存され、プロジェクトを開いている Studio のタブには数秒で反映されます。

• ホスト型： /mcp の代わりに https://mcp.luw.ai/studio を追加します（サインイン方法は同じです）。ホスト型のすべてのツールに加えて、Studio のツールも利用できます。
• ローカル： LUW_TOOLSETS に studio を追加します。例：LUW_TOOLSETS=generate,archigpt,personas,projects,studio。

「Luw Studio プロジェクト『Beach House』で、リビングの東側に 3×4 m の寝室を追加して窓を設け、家具を配置してください。」

シーンツールは、Luw Studio と同じコアで動作する、Pascal のオープンソース MCP ツール（MIT）です。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 のパッケージを 1 つダウンロードして、すぐに起動します。

設定

リモートサーバーのセルフホスト

同じパッケージで、ホスト型の 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.ai にサインインできるようにするには、LUW_MCP_OAUTH_SECRET を設定します（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.