Modulor MCP server

Modulor

Agent-native 的二维绘图 + 三维建模内核。没有 GUI，没有鼠标——JSON 进，几何出。

English: Modulor is an agent-native 2D drafting + 3D modeling kernel —

the geometry layer for the agent era. No GUI: the entire tool is a

self-describing JSON op protocol (77 ops, contract-tested) over a plain-JSON

document format, callable via CLI, JSON-Lines pipe, MCP server or Python.

Parametric recipes, architectural semantics, freeform surfaces, DXF/glTF

interop, a built-in verification loop (measure / validate / render-and-see),

and a conformance checker for the format. Agents read

AGENT_GUIDE.md; the API contract lives in

docs/API.md; the file format spec in

docs/FORMAT.md. Named after Le Corbusier's Modulor —

a universal measure for building, this time for machines.

传统 CAD软件 是为人类的眼睛和手设计的：菜单、视口、 捕捉、快捷键。Agent 调用它们时，要么模拟人类操作，要么穿过厚重的插件层。 Modulor 反过来：把 CAD 的几何核心保留下来，把交互层整个换成 Agent 的母语 ——结构化命令、结构化结果、结构化错误，外加一条"渲染成图、亲眼验证"的反馈回路。

┌─────────────────────────────────────────┐
   Agent ──────▶│  CLI batch │ CLI pipe │ MCP │ Python API │
                └──────────────────┬──────────────────────┘
                                   ▼
                       JSON 命令（自描述 op 协议）
                                   ▼
                ┌─────────────────────────────────────────┐
                │  几何内核：manifold3d (Clipper2 + Manifold) │
                │  2D/3D 布尔 · 偏移 · 拉伸 · 旋转体 · 切片    │
                └──────────────────┬──────────────────────┘
                                   ▼
        .json 文档 · SVG · DXF · PNG 渲染 · OBJ / STL / GLB

核心能力（77 个自描述操作，接口已冻结于 1.0-rc）

扩展生态：领域能力住扩展包——装上扩展即获得 mech.gear 渐开线齿轮（官方模板）； 三十行代码就能写出你自己的扩展，命名空间与 API 法律由机制强制， 见 docs/PLUGINS.md。

身份与治理：项目名/包名/CLI/格式标识已正式冻结； Standard（规格，供第三方实现）与 Core（参考实现，canonical 而非排他）的 边界、semver 与兼容政策、RFC 流程见 GOVERNANCE.md。

标准的两半都已成文并由测试看守：op 协议——docs/API.md （由注册表生成）+ 机器可读契约 docs/api.json，实现与契约 不一致时测试直接失败；文档格式——docs/FORMAT.md 规格

每份示例文档都在 CI 里对着 schema 验证。

• docs/document.schema.json（JSON Schema），

与主流 CAD 的互操作是契约（docs/INTEROP.md）： DXF 导出为 R2000 原生对象（ELLIPSE/SPLINE/HATCH/关联 DIMENSION/ BLOCK+INSERT），在 AutoCAD 里直接可编辑；导入保留块结构；每个导出文件 在 CI 里由 ezdxf（DXF）与 ifcopenshell（IFC4）做语义级校验。

（"bay3"、"leveltop('L2')"、"gridx('B')"）；recipeset 把生成 命令存进文档作为设计意图，set_param + regenerate 一条命令全模型 联动重建——"柱距 4m 改 5m，其他保持联动"就是这两个调用

• 参数化（文档 = 数据 + 配方）：任何数值字段接受表达式

标高 addlevel、房间 addroom（平面自动标注名称+面积 m²）、 面积报告 program（按名称/标高/类型汇总）、坡屋顶 addroof（平/单坡/双坡）、 楼梯 addstair（自动按舒适度公式 2R+T=630 排踏步）、幕墙 add_facade

• 建筑语义：轴网 add_grid（平面出轴线+编号气泡，交点可在表达式中引用）、

（参数变更、实体增删改、体积面积增量），recipe 让设计意图跨方案继承

• 方案迭代：snapshot / restore 快照，diff 对比两个方案

Shortened. The full README is on GitHub.