Cadlens Mcp

io.github.cadlens-co由 GitHub 账号 cadlens-co 发布v0.6.0更新于 Oct 25, 2026

Model Context Protocol server that wraps the CADLens REST API.

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

本地 MCP 服务器，封装 Cadlens CAD 解析 API，让助手上传 CAD 图纸并基于提取的实体、图层和元数据进行推理。

可以做什么
解析 CAD 文件：上传本地图纸或从 URL 获取文件，轮询直到解析完成，并可查询进行中或失败任务的状态。获取结果：以摘要、按类型分组的实体、指定图层上的实体或完整内容等形式取回解析结果。管理图片：刷新有时效的预签名 PNG 预览链接，无需重新下载完整结果。管理任务：列出该 API 密钥最近 100 个任务，并删除任务及其存储的产物。
适用场景
适合助手需要在没有 AutoCAD 或其他桌面软件的情况下读取 DWG、DXF、DWF、DWFX、DGN V7 或 PDF 图纸的场景，例如总结图纸、查看某一图层，或回答关于实体和元数据的问题。
运行要求
通过 npm 包以 npx 在本地运行，需要 Node.js。必须在 CADLENS_API_KEY 环境变量中提供 Cadlens API 密钥，密钥在 Cadlens 控制台创建。可选配置：CADLENS_API_BASE、WEBHOOK_PORT、WEBHOOK_PUBLIC_URL 和 REQUEST_TIMEOUT_MS。需要访问 Cadlens API 的网络连接；文件上限为 100 MB。
安装前请注意
CADLENS_API_KEY 中的 API 密钥属于机密，不应外泄。上传的 CAD 文件以及从 URL 获取的文件会发送到 Cadlens 云服务进行解析，除非可以接受，否则不要处理机密图纸。删除任务不可逆，并会一并删除其存储的产物。设置 WEBHOOK_PUBLIC_URL 会通过公网隧道暴露本地接收端。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Cadlens Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

cadlens-mcp

[npm version] [GitHub]

A Model Context Protocol server that wraps the Cadlens CAD parsing API so MCP-aware LLM clients (Claude Desktop, Claude Code, Cursor, Zed, Windsurf) can parse CAD files (.dwg, .dxf, .dwf, .dwfx, .dgn V7, .pdf, max 100 MB) and reason over the extracted entity, layer, and metadata payloads.

Cadlens converts CAD drawings into structured JSON without requiring AutoCAD or any desktop software — learn more at cadlens.co.

Install

Get an API key from the Cadlens dashboard first — keys start with cadl_ and are created in the dashboard for free.

Claude Desktop / Cursor / Windsurf

Add to your MCP client config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json
{  "mcpServers": {    "cadlens": {      "command": "npx",      "args": ["-y", "@cadlens/mcp-server"],      "env": {        "CADLENS_API_KEY": "cadl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"      }    }  }}

Claude Code CLI

bash
claude mcp add cadlens \  --env CADLENS_API_KEY=cadl_xxx \  -- npx -y @cadlens/mcp-server

Development (build from source)

bash
npm installnpm run build
export CADLENS_API_KEY="cadl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"node dist/index.js

Tools

ToolWhat it does
cadlens_parse_fileUpload a local CAD file, poll until parsed (5 min budget), return summary.
cadlens_parse_urlDownload a CAD file from a URL, then parse it like parse_file.
cadlens_get_jobCheap status check (PENDING / PROCESSING / COMPLETED / FAILED).
cadlens_get_resultFetch parsed content. mode: summary (default), entities_by_type, entities_on_layer, full.
cadlens_refresh_image_urlRe-fetch the 1h presigned PNG URL without re-downloading the full result.
cadlens_list_jobsThe 100 most recent jobs for the configured API key.
cadlens_delete_jobDelete a job and its S3 artifacts. Irreversible.

Configuration

Env varRequiredDefaultNotes
CADLENS_API_KEYyes—Created in the CADLens dashboard.
CADLENS_API_BASEnohttps://api.cadlens.co/v1Set to http://localhost:3001/v1 for local dev.
WEBHOOK_PORTno0 (random)Port for the in-process webhook receiver.
WEBHOOK_PUBLIC_URLnounsetSet to a tunnel URL (ngrok/cloudflared) to let CADLens hit the local receiver. When set, parse calls auto-register the webhook and the poller short-circuits on receipt.
REQUEST_TIMEOUT_MSno30000Per-HTTP-request timeout for CADLens calls.

Webhook short-circuit (optional)

If WEBHOOK_PUBLIC_URL is set, parse_file / parse_url register a per-process webhook URL alongside the upload. The webhook handler updates an in-memory job-state cache; the poller checks that cache before each HTTP GET and returns early when COMPLETED / FAILED arrives. This trims worst-case latency by up to one full poll tick (~1 s) without changing the tool surface.

Example tunnel setup:

bash
cloudflared tunnel --url http://localhost:8787 &export WEBHOOK_PORT=8787export WEBHOOK_PUBLIC_URL="https://<your-tunnel>.trycloudflare.com"

Development

bash
npm run typechecknpm run lintnpm testnpm run smoke   # tools/list smoke test against built binary

Project-scoped Claude agents

This repo ships five agents under .claude/agents/:

  • cadlens-api-debugger — diagnoses unexplained CADLens 4xx/5xx using mcp-server-reference.md.
  • mcp-tool-tester — drives JSON-RPC against the built server to validate tool responses.
  • mcp-tool-implementer — scaffolds new tools following the existing src/tools/* pattern.
  • cad-drawing-summarizer — uses the MCP tools to summarize a CAD file in natural language.
  • cad-layer-inspector — drills into a single layer of a parsed drawing.

Links

GitHub Topics

Add these topics to this repo for discovery: mcp mcp-server model-context-protocol ai-agents claude cad dwg dxf cad-api llm-tools engineering-api

License

MIT

来源：README.md，提交 0bb71e1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.6.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分