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 分