mcp-svg

MCP浏览器工具

提供方 juancresc

浏览器工具 未标注 API Key 社区 / 第三方 Claude DesktopClaude

Kerf is a browser-based CAD design editor for CNC cut drawings with a built-in MCP server, enabling Claude to collaborate live with you on 2D/3D design, dimensioning, layer management, automatic nesting, and SVG/DXF/GLB/STL export.

一句话选型结论

按资料字段整理

mcp-svg 属于浏览器工具类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Blend Deployment CNC cutting CAD editor Python MCP server 2D/3D design DXF/SVG export parametric design automatic nesting dimensioning

支持客户端

适用场景

Blend DeploymentCNC cuttingCAD editor

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mcp-svg当前 未标注 未标注 未标注 无 2026-09-29
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方juancresc上游标注的维护方 juancresc
分类浏览器工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-09-29上游最后核验时间

详细介绍

8.4 KB
来自项目仓库与上游目录的原文,未做删改

Kerf — MCP-first CNC design editor

A browser CAD-style editor for CNC cut drawings (1 unit = 1 mm) with an MCP server, so Claude can draw, edit and preview the same documents live with you.

Demo

  • Projects (.kerf) keep everything: project name, layers, parts (entities), 3D placements, parameters, material & stock. Several open at once in tabs (each with a 2D and a 3D view).
  • Drawing: click–click or drag, type exact sizes (length/angle, width/height, diameter), snapping, measuring tool, dimensions.
  • Layers: rename, colour, solid/dashed/dotted, lock, hide, reorder, description, CNC-export flag, pocket depth.
  • Entities: group a part's outline + holes. Double-click to edit inside, set quantity and 3D placement.
  • 3D preview of the assembled design, with sliders (e.g. desk height). Export GLB / STL.
  • Exports: CNC SVG and DXF (mm, true arcs, circles), parts for nesting (SVG + DXF per part, zipped), SVG, PNG. Imports: SVG, DXF.
  • Undo/redo, autosave session, Open/Save As in the data folder or anywhere on your computer.

Start```
docker compose up -d --build


Open the editor```
http://localhost:8765/

Open Claude Code in this folder (the MCP server is configured in .mcp.json)```
claude


Ask it to build something```
Draw a 400 × 300 mm box lid in 6 mm MDF with four 8 mm holes 20 mm from the corners, group it and show it in 3D

Connect Claude

In the editor, click Connect Claude (top right, or Help → Connect Claude). It shows copy-paste setups built from the editor's own address:
- Claude Code: a one-line claude mcp add … command.
- .mcp.json: a project config file.
- Claude Desktop: a config using mcp-remote.
- Prompt (curl, no MCP): a text you paste into Claude that explains the HTTP API with curl examples.

Each has a Copy button.

MCP tools

The kerf MCP server (SSE on port 8766) gives Claude the same editor you see. Tools act on the active tab.

  • Start here: get_guide returns the design guide: workflow, layers, 3D placement recipes, CNC rules and parametric scripts. Ask for one section with get_guide("placement"), "scripts", and so on.
  • Projects and tabs: get_document_info, list_tabs, switch_tab, new_document, open_document, save_document, close_document, revert_document, set_project_name, set_canvas_size, set_material, undo, redo, list_files.
  • Shapes: add_svg (many shapes, one undo step), add_element, update_element, remove_element, move_elements, transform_elements, duplicate, set_element_layer, list_elements, find_elements, get_svg.
  • Parts (entities) and 3D: group_elements, ungroup, move_to_entity, update_group (name, qty, 3D placement: rotation + position; the drawing→part matrix is automatic and follows the part when it's moved), describe_entity, list_groups, set_params (sliders).
  • Sheets: arrange_parts packs every part onto stock sheets (turning parts when that fits better), draws the sheets and a notes block, and keeps the 3D placement.
  • Layers: add_layer (with depth for pockets), update_layer, remove_layer, move_layer, list_layers.
  • Batch edits: apply_ops runs any list of ops as one undo step. Name an op with "as": "side" and refer to its result as "$side" ("$n" = op n also works).
  • Check and look: check_cnc (open outlines, holes smaller than the tool, duplicates, parts bigger than the sheet, parts overlapping or too close, parts off the sheets…), describe_assembly (every part's 3D world box, parts clashing), measure, add_dimension, take_screenshot("2d" · "3d" · "3d-exploded"), get_selection / set_selection (what you selected, or highlight parts for you).
  • Files for the shop: export_cnc (SVG or DXF), export_parts (one file per part, for nesting), export_svg, import_dxf.
  • Prompts: design_part, design_furniture, prepare_for_cutting.

Share links

http:///?open= opens a project from the data folder, or switches to its tab if it's already open. Add &view=3d to open it in 3D. Example: /?open=desk/desk.kerf&view=3d.

File → Copy link to this project copies the link for the current tab. The project must be saved in the data folder, and the current 2D/3D view is included.

A missing file just shows "not found". When deployed, a link like /?token=…&open=… signs in first and then opens the file.

Deploying (reachable from other machines)

By default Kerf only answers on this computer. To put it on a server, set these in docker-compose.yml → environment, and publish the ports (or put a reverse proxy in front):```yaml
ports:
- "8765:8765" # editor + HTTP API
- "8766:8766" # MCP (SSE)
environment:
- KERF_PUBLIC_URL=https://kerf.example.com # where people open the editor
- KERF_MCP_URL=https://kerf.example.com:8766/sse # optional; default: same host, port 8766
- KERF_TOKEN=change-me-to-a-long-random-string # required once KERF_PUBLIC_URL is set


- **Browser:** open `https://kerf.example.com/?token=…` once. That sets a login cookie; without it the editor shows a sign-in page.
- **API and MCP clients:** send `Authorization: Bearer `. The Connect Claude snippets already include it.
- **Refuses to start without a token:** the server exits if `KERF_PUBLIC_URL` is set but `KERF_TOKEN` isn't, because anyone could otherwise edit and delete your files.
- **Use HTTPS** (e.g. a Caddy or nginx proxy). Otherwise the token travels in plain text.

## Workflow: how drawings get made

There are three ways to build a design. They share one server-side document, so every change shows up live in the browser.

1. **By hand in the editor.** Draw, type exact sizes, group parts, place them in 3D.
2. **Claude through MCP (the main way).** Claude calls the `kerf` MCP tools: `add_svg`, `update_element`, `group_elements`, `update_group` (3D placement), `set_params`, `take_screenshot`, and others. Each call is an undoable edit on the open tab. Use this for one-off parts, edits, checks (`check_cnc`, `measure`) and for opening or saving projects.
3. **A Python generator (optional).** Some designs are really a formula, like the desk in `data/desk/`: 17° tracks, a sawtooth pitch, fillets, collision checks at every height. For those, a plain script (`data/desk/generate.py`) computes the geometry, runs its own checks, and writes a `.kerf` project. `--push` then opens or reloads it in the editor through the HTTP API. The editor and MCP stay the place to view, tweak, screenshot and export. Re-running the script regenerates everything, so treat the script as the source and the `.kerf` as its output. The script needs no dependencies, only Python 3.

In practice: Claude writes and edits the generator, runs it, pushes the result, and checks it with `take_screenshot` (2D, 3D, exploded) through MCP.

**Script helpers for generators.** `mcp-server/kerf_script.py` is served by the editor at `GET /api/script`, so Claude can fetch it even when Kerf runs on another machine. It is standard library only and handles:
- `Drawing`: a whole project as one batch: parts drawn in their own coordinates with holes, pockets, labels and 3D placement, local world-box checks (`expect`), `arrange()` onto sheets with notes, and `run()` (new tab, or rebuild a tab in place; `--dry`, `--save`);
- the HTTP calls: posting ops to a named tab, opening a new tab without taking over the one you're looking at, saving, `check` (the same checks as `check_cnc`, via `GET /api/check?tab=`) and `assembly_report` (`describe_assembly`, via `GET /api/assembly?tab=`);
- outlines with fillets, dog-bones and arcs, with the SVG arc flags computed for you;
- `place()`, which puts a part on the sheet (optionally turned) and returns the matching 3D matrix;
- `world_box()`, to check where a part lands in 3D.

`add_layer` accepts `exist_ok`, so a script can start with `clear` and be re-run safely. The guide's *Parametric scripts* section has a short example, which the tests run.

### Ideas

- **Generators as a first-class feature:** a `run_generator` MCP tool and a *Parameters* panel. Changing a number (width, height, material thickness) would re-run the script and update the tab, keeping manual edits on separate layers.
- Shapes → paths conversion and text → outlines for CAM.
- True-shape nesting (today `arrange_parts` packs bounding boxes; for tighter layouts: export parts → Deepnest/SVGnest).

Tests```
docker compose run --rm --no-deps -T --entrypoint python kerf -m pytest -q tests

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
mcp-svg 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

mcp-svg 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

mcp-svg 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

mcp-svg 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

mcp-svg 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

mcp-svg 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、CNC cutting、CAD editor、Python、MCP server、2D/3D design。具体工具清单以官方文档为准。

mcp-svg 需要什么运行环境?

运行时为 python。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-09-29。