A Model Context Protocol 서버로 LLM (예: Claude) 드라이브 Marvelous Designer (및 CLO, 같은 공유 MD의 임베디드 파이썬 해석기 내부 코드로 Python API).

C++ SDK, 플러그인 빌드 또는 CLO-SET API 키가 필요합니다. 내장 Python 편집기.

어떻게 작동합니까?

MD의 임베디드 파이썬 (3.11)은 ** 일정 배경 스레드, 그래서 listener는 MD의 GUI 스레드에서 실행하는 일반 차단 허용 루프입니다. **있음 청취자는 실행되고, MD의 창은 반응하지 않습니다 ** — 그것은 예상됩니다. 설치하기 shutdown_listener] 도구 (또는 MD 닫기).

요구 사항

• Marvelous Designer 2026 (또는 CLO 2026) - Plugins ▸ Python Editor를 사용해야합니다.
• MCP 서버를 실행하는 기계에 Python 3.10+ 및 [T2]
• MCP 서버와 MD는 **same 기계에서 실행 ** (리스너는 127.0.0.1)

설치

실행

##1. Marvelous Designer 내부의 청취자 시작

scripts/md_start_listener.py 블록 소켓 리스너 시작 127.0.0.1:7421. MD의 GUI 동결은 실행 중이다 — 그 준비 상태입니다. 나중에 shutdown_listener] 도구 (또는 MD를 닫아). 이름 * 왜 MD 동결합니까? 아래.

marvelous-designer-mcp

A Model Context Protocol server that lets an LLM (e.g. Claude) drive Marvelous Designer (and CLO, which shares the same Python API) by running code inside MD’s embedded Python interpreter.

It does not need the C++ SDK, a plugin build, or a CLO-SET API key — just MD’s built-in Python Editor.

How it works

LLM  ──MCP(stdio)──▶  MCP server (this repo, FastMCP)
                          │  JSON-per-line over TCP 127.0.0.1:7421
                          ▼
                      md_listener.py  (you paste it into MD's Python Editor)
                          │  exec() in MD's interpreter
                          ▼
                      MD Python API:  import_api / export_api / fabric_api /
                                      pattern_api / utility_api / ...

MD’s embedded Python (3.11) does not schedule background threads, so the listener is a plain blocking accept loop that runs on MD’s GUI thread. While the listener is running, MD’s window is unresponsive — that’s expected. Stop it with the shutdown_listener tool (or by closing MD).

Requirements

• Marvelous Designer 2026 (or CLO 2026) — Plugins ▸ Python Editor must be available
• Python 3.10+ and uv on the machine running the MCP server
• The MCP server and MD run on the same machine (the listener binds 127.0.0.1)

Setup

git clone https://github.com/ysk424/marvelous-designer-mcp.git
cd marvelous-designer-mcp
uv sync

Running

1. Start the listener inside Marvelous Designer

scripts/md_start_listener.py starts a blocking socket listener on 127.0.0.1:7421. MD’s GUI freezes while it runs — that’s the ready state. Stop it later with the shutdown_listener tool (or by closing MD). See Why does MD freeze? below.

Option C — auto-register (one shot, recommended). Run

uv run python scripts/install_md_plugin.py

once. It writes the launcher into MD’s pluginSettings.json, so on the next MD launch Plugins ▸ Plug-in ▸ md_start_listener is there waiting to be clicked.

Option B — register manually. Plugins ▸ Plug-in Manager ▸ +ADD, pick scripts/md_start_listener.py. Same outcome as Option C, just hand-driven.

Option A — paste into the Python Editor. Open Plugins ▸ Python Editor, paste the whole contents of scripts/md_start_listener.py, run it. (Paste it in one go from a text editor — pasting line by line can mangle indentation.) Good for development; the editor’s console shows prints.

Either way, status and errors are appended to ~\md_mcp_listener.log (handy in plugin mode, where stdout may not be visible).

2. Start the MCP server

uv run python -m marvelous_designer_mcp

Or let Claude Desktop launch it (below).

3. Claude Desktop config

Add to claude_desktop_config.json