Back to Browse

Zumen Gate MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Read, search, render, edit and convert CAD drawings (JWW, DWG, DXF, SXF, PDF) via zumen-gate.

About

Read, search, render, edit and convert CAD drawings (JWW, DWG, DXF, SXF, PDF) via zumen-gate.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your zumen-gate API key (free registration at https://zumen-gate.com/developers)Required

Environment variable: ZUMEN_GATE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "zumen-gate-mcp": {
      "command": "uvx",
      "args": [
        "zumen-gate-mcp==0.1.1"
      ],
      "env": {
        "ZUMEN_GATE_API_KEY": "your-zumen-gate-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

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.

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

ToolWhat it doesCalls
list_formatsFormats, extensions, which can be read and written, paid outputs0
inspect_drawingSummary: format, paper, scale, layers, counts, texts1
query_drawingEntities matching layer / kind / text / area, with totals1
render_drawingPNG image and pixel-to-coordinate mapping1
edit_drawingLocal edits on a working copy, blank drawings, undo0 (1 the first time)
convert_drawingConvert and save the outputs1, or 10 for paid outputs
get_jobState of a long conversion0
account_statusCalls left, expiry dates, this month's use0

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

SettingMeaning
ZUMEN_GATE_API_KEYYour API key (required, except for list_formats)
ZUMEN_GATE_LOCALEja or en for messages (default: from the system language)
--rootThe working folder (default: the current folder)
--only-text-feedbackReturn 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

Reviews

No reviews yet

Be the first to review this server!