AI 코딩 에이전트가 무한 캔버스 디자인 보드를 읽고 쓸 수 있게 합니다. 프로젝트 생성, HTML 화면 생성 및 편집, 프로토타입 내보내기가 가능합니다.
다른 이름 Bearisbug/Quilt, quilt-canvas
- 스타
- 106
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 4일
- 라이선스
- Apache-2.0
Quilt MCP란?
AI 코딩 에이전트가 무한 캔버스 디자인 보드를 읽고 쓸 수 있게 합니다. 프로젝트 생성, HTML 화면 생성 및 편집, 프로토타입 내보내기가 가능합니다.
프로젝트 README에서 생성된 요약
Quilt MCP server 정보
Quilt는 AI 에이전트에게 설명을 전달하는 것만으로 멀티 스크린 애플리케이션 프로토타입을 설계할 수 있게 해줍니다. 이 도구는 코딩 에이전트가 HTML 화면을 읽고 쓰고, 디자인 시스템을 관리하며, 인터랙티브 프로토타입을 구축할 수 있는 무한 캔버스를 제공합니다. 클라우드 백엔드나 사용자 계정 없이 단일 프로세스를 사용하여 로컬 머신에서 완전히 작동하며, 모든 데이터는 홈 디렉토리에 저장됩니다.
개발자는 streamable HTTP를 통한 MCP를 사용하여 에이전트를 연결할 수 있으며, 57개의 특화된 도구와 7개의 리소스를 사용할 수 있습니다. 기존 Claude 구독, Anthropic 또는 Gemini API 키, 또는 OpenAI 호환 엔드포인트를 사용하여 생성 프로세스를 구동할 수 있습니다. 이 시스템은 4~6개의 화면 흐름 생성부터 사이드바 및 탭 바와 같은 공유 컴포넌트 관리까지 모든 것을 처리합니다. 로컬 PGlite 데이터베이스를 사용하므로 디자인 데이터는 개인적으로 유지되며 사용자가 직접 제어할 수 있습니다.
활용 사례
- 1멀티 스크린 앱 흐름 생성AI 에이전트에게 캔버스 위에 일관된 여러 HTML 화면을 가진 완전한 애플리케이션 흐름을 생성하도록 요청합니다.
- 2반복적인 컴포넌트 편집에이전트에게 생성된 화면 내의 특정 요소나 블록을 수정하도록 지시하여 UI를 정교화합니다.
- 3신속한 프로토타이핑 및 내보내기설계된 화면 모음을 단일 오프라인 파일로 내보낼 수 있는 클릭 가능한 프로토타입으로 변환합니다.
- 4개별 컴포넌트 스케치스케치북 기능을 사용하여 UI 요소를 정식 프로젝트로 옮기기 전에 초안을 작성합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Quilt MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Quilt MCP 설치
$ claude mcp add quilt -- npx -y quilt-canvasCursor에 Quilt MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"quilt": {
"command": "npx",
"args": [
"-y",
"quilt-canvas"
]
}
}
}VS Code에 Quilt MCP 설치
.vscode/mcp.json
{
"servers": {
"quilt": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"quilt-canvas"
]
}
}
}VS Code CLI에 Quilt MCP 설치
$ code --add-mcp '{"name":"quilt","type":"stdio","command":"npx","args":["-y","quilt-canvas"]}'Claude Desktop에 Quilt MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"quilt": {
"command": "npx",
"args": [
"-y",
"quilt-canvas"
]
}
}
}Codex에 Quilt MCP 설치
$ codex mcp add quilt -- npx -y quilt-canvasCodex config.toml에 Quilt MCP 설치
~/.codex/config.toml
[mcp_servers.quilt] command = "npx" args = ["-y", "quilt-canvas"]
Gemini CLI에 Quilt MCP 설치
$ gemini mcp add -s user quilt npx -- -y quilt-canvasGemini settings.json에 Quilt MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"quilt": {
"command": "npx",
"args": [
"-y",
"quilt-canvas"
]
}
}
}구성
ANTHROPIC_API_KEYGEMINI_API_KEYLLM_DRIVER
| 이름 | 설명 | 유형 |
|---|---|---|
| ANTHROPIC_API_KEY | — | |
| GEMINI_API_KEY | — | |
| LLM_DRIVER | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기Quilt runs on your machine: one process, no account, no cloud backend, data in ~/.quilt. Generation goes through the channel you pick: your Claude subscription (the claude CLI), an Anthropic, Gemini or OpenAI-compatible API key, or a Claude Code session you already have open.
What it does
- Generate. Describe the app. Quilt plans a 4–6 screen main flow (or the 1–4 screens you ask for), generates each screen as self-contained HTML in the project's design system, lints and screenshots it, and lays it out on the canvas. Ask for up to 4 candidates per screen and adopt one.
- Edit. Select screens and describe the change. In a focused screen,
⌘Epicks any element: change its text, classes or link with zero tokens, or have AI regenerate just that block. - Sketchbook. A full-page board for one-off components and pages outside any project. Describe one, refine it by picking elements, step through versions, then put it into a project as a new screen, over a screen, or in place of one block.
- Canvas. Pan, zoom, drag, align and distribute.
⌘Kjumps to any screen; a minimap and a filterable screen list keep large projects navigable. Double-click a screen to use it live. - Prototype. Links, forms and
data-hrefbuttons move between screens with state kept and a back stack. Overlay screens (sheets, dialogs) open on top of the current one; state variants (empty, error, signed out) share a route. Broken links are flagged and fixed in one click. Export the whole prototype as one offline HTML file. - Design system. A seed colour or an explicit brand palette (light and dark) yields tokens, a
DESIGN.mdand component recipes. Upload assets, save presets, and re-flow every screen when tokens change. - Shared components. Tab bars, app bars and sidebars live on the canvas as components; edit one and every screen using it updates without a model call.
- History. Every generation, edit and agent write is a revision you can roll back to.
- Together. People on your network who open the same project see each other's cursors, selections and views, and can follow one another.
- Settings. Generation channels (keys encrypted at rest), a usage dashboard by day, model, project and task, an optional local record of UI actions and model calls, and a Chinese or English interface.
- MCP, both ways. Your coding agent gets 57 tools and 7 resources at
http://127.0.0.1:3100/mcp. Quilt can also hand a job to a running Claude Code session.
How it works
Browser (React 19 canvas) ──REST / SSE──▶ quilt process (Hono, 127.0.0.1:3100)
◀─iframe────── preview origin (127.0.0.1:3101, read-only HTML)
├─ in-process job queue + worker (LLM, lint, inject, screenshot)
├─ MCP server (Streamable HTTP, same service layer as REST)
├─ chat jobs over the API (Claude Agent SDK subprocess, talks to the same MCP)
└─ agent delivery (hands jobs to a local Claude Code session)
~/.quilt: PGlite database · objects/ · config.env
Screens are plain HTML with Tailwind classes and the project's tokens; stable element ids let an edit target one block. The preview runs on a separate origin, so generated scripts cannot reach Quilt's own storage.
docs/DESIGN.md is the single source of truth: requirements, data model, API contract, state machines and ADRs. docs/TEST.md holds the test cases and the log of every test round.
Quick start
Requirements:
- Node.js 22 or newer, pnpm 11
- Chrome or Edge for screenshots (otherwise run
npx playwright install chromiumonce) - A generation channel: the
claudeCLI logged in (the default,LLM_DRIVER=agent-sdk), an Anthropic or Gemini API key, or an OpenAI-compatible endpoint added in settings
Run the packaged app
pnpm install
pnpm build # builds the web bundle and apps/cli/dist
node apps/cli/bin/quilt.js # or: npx quilt-canvas, once the package is published
The first run creates ~/.quilt (embedded PGlite database, object store, config.env with generated secrets), runs migrations and opens http://127.0.0.1:3100. Run it again with the same home and your projects are there.
Flags: --home <dir>, --port / --preview-port (default 3100 / 3101), --no-open. The default channel is set in ~/.quilt/config.env:
LLM_DRIVER=agent-sdk # agent-sdk (local Claude subscription) | anthropic | gemini
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
Run from source
pnpm install
cp .env.example .env # leave DATABASE_URL empty to use embedded PGlite
docker compose up -d # optional: Postgres on 127.0.0.1:5439 if you set DATABASE_URL
pnpm dev # API + worker + preview on 3100/3101, Vite on 6688
Open http://localhost:6688. Migrations run at API startup; every key in .env.example is documented inline.
Connect your coding agent
claude mcp add --transport http quilt http://127.0.0.1:3100/mcp
The server listens on loopback only, so there is no authentication. Everything the canvas and the sketchbook do is available as a tool; only API keys stay in the settings panel.
Read with get_outline (a compact summary of every screen) before get_screen. Keep writes small: patch_screen for a partial change, create_upload_url plus several append_upload chunks for a screen over ~8 KB, because one very long tool argument can cut a streamed model response short. Writes carry expectedRevisionId and return 409 on a stale base, so two writers cannot overwrite each other.
The other direction: choose "hand to local Claude Code" as the channel in the composer and pick a running session. Quilt delivers the prompt there; the session writes back over the same MCP and closes the job.
- Projects:
quilt.list_projects,create_project,get_project,update_project,delete_project,create_surface,update_surface,delete_surface - Reading:
get_outline,get_screen,get_screenshot,get_revision,list_revisions,list_candidates,get_design_contract,get_app_map,list_assets,list_messages,list_jobs,get_job,get_job_events,list_runners,list_design_presets - Writing screens:
validate_screen,create_screen,update_screen,patch_screen,create_upload_url,append_upload,link_screens,move_screens,edit_element,restore_revision,adopt_candidate,delete_screen - Sketchbook:
get_sketchbook,create_draft,copy_draft,move_drafts - Shared components:
create_component,update_component,delete_component - Design system:
update_design_system,create_design_preset,apply_design_preset,delete_design_preset,create_asset,delete_asset - Model jobs:
generate_screens,edit_screens,regenerate_subtree,edit_component,propose_design_system,export_prototype,get_export,cancel_job,finish_job - Resources:
design-md,tokens,app-map,golden,screen-html,screen-screenshot,attachment
Repository layout
apps/api Hono server: REST, MCP, SSE, preview origin, in-process worker, Drizzle schema + migrations
apps/web Vite + React 19 + Tailwind 4 canvas and sketchbook
apps/cli esbuild bundle of api + core + web → the `quilt-canvas` npm package
packages/core shared: zod schemas, prompt contract, lint rules, runtime injection, export, tokens, outline
tests/unit node:test unit tests for the pure functions in core and the canvas (pnpm test)
tests/e2e Playwright scripts that execute the cases in docs/TEST.md
docs/CHANGELOG.md older change-log rows moved out of DESIGN.md / TEST.md
docs/DESIGN.md design document (requirements, data model, API contract, state machines, ADRs)
docs/TEST.md test cases with REQ traceability and the execution log
CLAUDE.md working discipline for coding agents contributing to this repo
Development
pnpm typecheck # tsc across core / api / web
pnpm test # unit tests (node:test, ~1.5 s, no database or browser)
pnpm build # web bundle + CLI package
pnpm seed # wipe the database DATABASE_URL points at, create two demo projects
pnpm mcp:call <tool> '<json>' # call an MCP tool against the running server
The end-to-end suites in tests/e2e run against an isolated stack (scripts/e2e-stack.sh; scripts/e2e-all.sh runs them in order). They wipe the database they point at, so they refuse to start unless its name ends in _test. LIVE_LLM=0 skips the turns that need a real model; environment details are in docs/TEST.md §3.
Every change goes the same way: update docs/DESIGN.md, then the code, then the affected cases in docs/TEST.md, then run and log a round.
Status
v1.42, local edition: it runs on one machine, and people on the same network can open it together. Mobile and desktop screens, plus free-form drafts in the sketchbook. Deferred, not dropped: multi-user SaaS (login, quotas, remote dispatch). Out of scope: production React code generation, native rendering.
License
Apache-2.0. See LICENSE.
Quilt MCP 질문
Quilt MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add quilt -- npx -y quilt-canvas를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Quilt MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Quilt MCP server는 인증이 필요한가요?
아니요. 서버는 loopback에서만 리스닝하므로 별도의 인증이 필요하지 않습니다. API 키는 설정 패널에 저장됩니다.
Quilt MCP server는 어떤 도구를 제공하나요?
프로젝트, 화면 읽기 및 쓰기, 스케치북 초안, 공유 컴포넌트, 디자인 시스템, 모델 작업을 포함하는 57개의 도구와 7개의 리소스를 제공합니다.
두 에이전트 간의 쓰기 충돌을 어떻게 방지하나요?
쓰기 작업 시 expectedRevisionId를 포함하며, 베이스 리비전이 오래된 경우 409 오류를 반환하므로 두 작성자가 서로의 작업을 덮어쓸 수 없습니다.
에이전트가 화면을 효율적으로 읽으려면 어떻게 해야 하나요?
먼저 get_outline을 호출하여 모든 화면의 요약 정보를 가져온 다음, 실제로 필요한 화면에 대해서만 get_screen을 호출하십시오.