Skip to main content
Glama

zumen-gate-mcp

An MCP server and command-line tool for the zumen-gate drawing API. It lets Claude and other MCP clients read, search, render, edit and convert CAD drawings: Jw_cad (JWW), DWG, DXF, SXF (SFC/P21), PDF, and more.

日本語の説明

  • Read: format, paper, scale, layers, entity counts and texts of a drawing.

  • Search: entities by layer, kind, text or area, with lengths and areas in real millimetres.

  • Render: a PNG of the drawing or a part of it, with the pixel-to-coordinate mapping.

  • Edit: change texts, layers, colors and coordinates, delete and add entities, or draw a new JWW or DXF from scratch, then write it back in its original format.

  • Convert: between drawing formats (DXF, DWG, JWW, SFC, P21, PDF, SVG, PNG, and STL/OBJ/STEP for 3D models).

Reading and converting run on the zumen-gate API with a deterministic CAD engine (no generative AI on the server). Edits run locally on a working copy of the drawing.

Get an API key

Register for free at zumen-gate.com and create a key under Account → API keys. The free plan includes a monthly allowance of calls; see the price list for paid outputs and more calls.

Related MCP server: QCAD MCP

Install

You need uv (uvx runs the server without a separate install). Replace zg_live_... with your key. --root is the folder whose drawings the tools may read; outputs are written to zumen-gate-out/ inside it.

Claude Code

claude mcp add zumen-gate -e ZUMEN_GATE_API_KEY=zg_live_... -- uvx zumen-gate-mcp --root .

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and other clients that use the same format:

{
  "mcpServers": {
    "zumen-gate": {
      "command": "uvx",
      "args": ["zumen-gate-mcp", "--root", "/path/to/drawings"],
      "env": { "ZUMEN_GATE_API_KEY": "zg_live_..." }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.zumen-gate]
command = "uvx"
args = ["zumen-gate-mcp", "--root", "/path/to/drawings"]
env = { ZUMEN_GATE_API_KEY = "zg_live_..." }

VS Code

code --add-mcp '{"name":"zumen-gate","command":"uvx","args":["zumen-gate-mcp","--root","${workspaceFolder}"],"env":{"ZUMEN_GATE_API_KEY":"zg_live_..."}}'

Claude Code plugin: this repository is also a plugin with a skill that teaches the model how to work with drawings. Add it with /plugin from a marketplace that lists it, or copy skills/zumen-gate/SKILL.md into your project's .claude/skills/.

Tools

Tool

What it does

Calls

list_formats

Formats, extensions, which can be read and written, paid outputs

0

inspect_drawing

Summary: format, paper, scale, layers, counts, texts

1

query_drawing

Entities matching layer / kind / text / area, with totals

1

render_drawing

PNG image and pixel-to-coordinate mapping

1

edit_drawing

Local edits on a working copy, blank drawings, undo

0 (1 the first time)

convert_drawing

Convert and save the outputs

1, or 10 for paid outputs

get_job

State of a long conversion

0

account_status

Calls left, expiry dates, this month's use

0

Every answer includes the calls counted and the calls left. Writing JWW, DWG, SFC, P21 or STEP is a paid output; without enough paid calls the conversion returns a preview and a loss report instead.

Command line

The same operations are available as zumen-gate:

export ZUMEN_GATE_API_KEY=zg_live_...
zumen-gate inspect plan.jww
zumen-gate query plan.jww --layer 壁 --kind LINE
zumen-gate render plan.jww --bbox 0 0 120 80
zumen-gate edit plan.jww --ops '[{"op": "replace_text", "pattern": "Old Co.", "replacement": "New Co."}]'
zumen-gate convert *.jww --to dxf
zumen-gate account

Settings

Setting

Meaning

ZUMEN_GATE_API_KEY

Your API key (required, except for list_formats)

ZUMEN_GATE_LOCALE

ja or en for messages (default: from the system language)

--root

The working folder (default: the current folder)

--only-text-feedback

Return render_drawing as text only (no image)

How files are handled

  • Only files inside --root are read; symbolic links that lead outside are refused. Files are sent only if their extension (and, where the format has one, their signature) says they are drawings.

  • The original drawing is never modified. Edits are kept as versions in .zumen-gate/ inside the working folder; outputs go to zumen-gate-out/.

  • Text read from drawings is marked as data for the model, not instructions.

  • See the zumen-gate terms and privacy policy for how the API handles uploaded drawings.

Development

uv sync
uv run pytest
uv run ruff check src tests

License

MIT

Available Tools

8 tools
account_statusA
Read-only

Calls left in each allowance with expiry dates, this month's use, and the price list. Uses no calls.

Inputs: no named parameters.

convert_drawingA

Convert a drawing (or its working copy) and save the outputs in the output folder (zumen-gate-out by default). Returns the saved paths and the main losses. Uses 1 call; writing JWW, DWG, SFC, P21 or STEP uses 10, and without enough paid calls returns only a preview and the loss report.

to: dxf, dwg, jww, sfc, p21, pdf, svg, png, ir, or for 3D models stl, obj, step, glb. version: the output version (e.g. a DWG version). scale: the output scale like "1/100". pages: for PDF input, pages like "1-3". A conversion longer than 40 s returns a job_id; call get_job with it.

Inputs: to (required), path (required), pages, scale, +3 more.

edit_drawingA

Edit a drawing locally (no calls, except 1 the first time to fetch the drawing as IR). Every edit is saved as a new version of the working copy; the original file is never changed. Returns the counts changed, the IDs and real lengths of added entities, and the version.

ops: a list of operations, applied all or nothing: {"op": "set", "ids": [...] or "where": {"layer"|"kind"|"text": ...}, "fields": {...}} fields: layer, color (0-256 or "#RRGGBB"), linetype, lineweight_mm, or the kind's geometry and text fields (p1, p2, center, radius, insert, height, text...). {"op": "delete", "ids": [...]} or with "where" {"op": "replace_text", "pattern": "old", "replacement": "new", "where": {...}?, "regex": false} {"op": "add_layer", "name": "walls", "color": 5} {"op": "add", "entities": [{"kind": "LINE", "layer": "walls", "p1": [0, 0], "p2": [36.4, 0]}]} kinds: LINE, CIRCLE, ARC, POINT, LWPOLYLINE, TEXT, MTEXT. Coordinates are drawing units (see inspect_drawing; for Jw_cad, millimetres on paper). To pick by area, get IDs with query_drawing first. No geometric operations (move, copy, offset): compute new coordinates and use set or add. create: start a blank drawing at path (which must not exist): {"format": "jww" or "dxf", "paper": "A3", "scale": "1/100", "layers": ["walls", "text"]} undo: go back one version. reset: discard the working copy (start again from the file).

Inputs: path (required), ops, undo, reset, +1 more.

get_jobB
Read-only

The state of a long conversion started by convert_drawing or edit_drawing: running (with elapsed seconds), or done with the saved outputs, or the error. Uses no calls.

Inputs: job_id (required).

inspect_drawingA
Read-only

Summarize a drawing: format and version, paper, coordinate units and scale (real mm per unit; for Jw_cad per layer group), bounding box, entity counts by kind, layers, the first texts, sheets or pages, and what could not be read. Uses 1 call.

path: a drawing file inside the working folder (or an .ir.json.gz file). use_edits: send the working copy if edit_drawing made one (default true). pages: for PDF, pages like "1-3,5". sheet: a sheet or layout name if the drawing has several.

Inputs: path (required), pages, sheet, use_edits.

list_formatsA
Read-only

List the drawing formats: extensions, which can be read (2D or 3D) and written, which outputs are paid (use 10 calls), and which are beta. Uses no calls and needs no API key.

Inputs: no named parameters.

query_drawingA
Read-only

List entities matching all given conditions, with IDs, layers, kinds, texts and lengths, plus totals (count, length and area, also in real mm). Uses 1 call.

layer / kind: one name or a list (kinds: LINE, ARC, CIRCLE, LWPOLYLINE, TEXT, MTEXT, INSERT, DIMENSION, HATCH...). text: a substring of the entity text (text_regex=true for a regular expression). bbox: [xmin, ymin, xmax, ymax] in drawing coordinates; bbox_mode "intersects" (default) or "within". ids: entity IDs. include_entities: also return each entity in IR form (use it as a model for edit_drawing's add). limit: 1-500 (default 50); pass next_cursor back as cursor for the next page. Narrow by layer or bbox first.

Inputs: path (required), ids, bbox, kind, +8 more.

render_drawingB
Read-only

Draw the drawing (or part of it) as a PNG image and return it with the mapping from pixels to drawing coordinates. The PNG is also saved in the output folder. Uses 1 call.

bbox: [xmin, ymin, xmax, ymax] to zoom in. layers: only these layers. highlight_ids: entity IDs to mark. width_px: the long side in pixels (default 1600, at most 2576).

Inputs: path (required), bbox, layers, width_px, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 8 tools

    Disambiguation4/5

    Each tool targets a distinct action on a drawing (inspect, query, render, edit, convert) or a distinct auxiliary concern (account_status, list_formats, get_job). The only mild overlap is between inspect_drawing and query_drawing, since both summarize entities, but the descriptions clarify that one is a whole-file overview and the other is a filtered entity listing with pagination. Boundaries are otherwise clear.

    Naming Consistency4/5

    The dominant pattern is a clean verb_noun scheme: inspect_drawing, query_drawing, render_drawing, edit_drawing, convert_drawing, list_formats, get_job. The single deviation is account_status, which is noun-first rather than verb-first, but it is still readable and unambiguous. Minor inconsistency only.

    Tool Count5/5

    Eight tools is well-scoped for a CAD gateway: five drawing operations plus three supporting utilities (formats, account, job polling). Each tool earns its place, and the async job tool is justified by the long-running conversion path. No bloat and no obviously thin area.

    Completeness4/5

    The lifecycle is well covered: discover formats, inspect, query, render, edit (set/delete/replace_text/add_layer/add/create/undo/reset), convert, and poll long jobs, with billing visibility. The main gaps are the explicit absence of geometric operations (move, copy, offset) and no way to list or manage prior working-copy versions beyond undo/reset, though both have documented workarounds.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to read and edit ZWCAD drawings directly, including summarizing drawings, querying layers and entities, reading dimensions and text, and creating lines, text, and blocks.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to automate 2D architectural drafting and CAD file management, including DXF/DWG parsing, SVG/PNG/PDF rendering, wall extrusion to 3D STL meshes, room and beam analysis, block/script library access, and persistent depot storage via a REST API and MCP tools.
      18
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to control CAD applications like AutoCAD, ZWCAD, GstarCAD, and BricsCAD through natural language or direct tool calls. Supports drawing, layer and entity management, block operations, data export, and file handling via 7 unified MCP tools covering 56 CAD commands.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants like Claude for Desktop or Cursor to control supported CAD applications through MCP, supporting drawing, layer and entity management, block operations, data export, and file/session control via natural language or unified tool calls.
      -