atelier-mcp

An AI architect that plugs into any MCP client — Claude Code, OpenAI Codex CLI, Gemini CLI, Claude Desktop, Cursor… — for Vietnamese tube houses: floor plans with proper TCVN symbols, a live two-way browser editor (drag walls, type exact mm), furnished 3D walkthrough, sun study, rough cost estimate, and a numbered A3 PDF / DXF / glTF / IFC documentation set.

Bản gốc tiếng Việt + toàn bộ tài liệu thiết kế: github.com/lebac-svg/Atelier

Install

Atelier is a standard MCP server, not tied to Claude. Stand in your house folder (one folder = one house — the model lives there) and run ONE command — it detects every MCP client on your machine (Claude Code, Codex CLI, Gemini CLI, Claude Desktop, Cursor) and registers with each:

cd my-house
npx -y atelier-mcp setup

Or register manually with your client of choice:

claude mcp add atelier -- npx -y atelier-mcp   # Claude Code
codex mcp add atelier -- npx -y atelier-mcp    # OpenAI Codex CLI
gemini mcp add atelier npx -y atelier-mcp      # Gemini CLI

That's it. Open your agent in that folder and say "design me a 4×16m tube house, 2 floors, 3 bedrooms". Works best with a model that reads Vietnamese well (tool descriptions are Vietnamese-first) and a client that shows images from tool results — the agent inspects its own drawings.

Optional, for PNG/PDF export (first time only):

npx playwright install chromium

GUI clients (Claude Desktop, Cursor, …) have no working folder — set ATELIER_DIR, e.g. in claude_desktop_config.json:

{
  "mcpServers": {
    "atelier": {
      "command": "npx",
      "args": ["-y", "atelier-mcp"],
      "env": { "ATELIER_DIR": "C:\\path\\to\\my-house" }
    }
  }
}

What you get

• 18 MCP tools — one parametric model as the single source of truth; every change is a validated transaction (geometry + Vietnamese building standards + optional Lỗ Ban + local zoning declared in the brief).
• Live editor — editor_open starts a browser editor in the same process: everything the agent builds appears in 2D (true drafting symbols) and 3D instantly; you drag walls back, type 4200 ⏎ for exact millimetres, and the agent adapts. The user always wins (soft-locks).
• Deliverables — numbered sheet set KT-01…: dimensioned plans, front elevation, section through the stair, schedules, cost estimate → multi-page A3 PDF, DXF (true mm, opens in CAD), SVG, GLB (Blender-ready), concept IFC4.
• Trace old plans — underlay_import places an old DXF or a photo under the plan to rebuild from; underlay_trace proposes walls from the linework.

Local prices: drop a rules/don-gia.json in your house folder to override the packaged cost table.

Concept-level design — not construction documents (no structure/MEP, no permit drawings).

Env

| Variable | Default | Meaning | |---|---|---| | ATELIER_DIR | current folder | where atelier.project.json + .atelier/ live | | ATELIER_PORT | 4823 | live editor port (busy → tries +1…+9) | | ATELIER_HOST | 127.0.0.1 | set 0.0.0.0 to open the editor/share links to your LAN |

MIT © lebac-svg