cadlens-mcp

cadlens-mcp

Model Context Protocol サーバーです。Cadlens CAD parsing API をラップしており、MCP 対応の LLM クライアント（Claude Desktop、Claude Code、Cursor、Zed、Windsurf）で CAD ファイル（.dwg、.dxf、.dwf、.dwfx、DGN V7、.pdf、最大 100 MB）を解析し、抽出したエンティティ、レイヤー、メタデータのペイロードに基づいて推論できます。

Cadlens は、AutoCAD やデスクトップソフトウェアを必要とせずに、CAD 図面を構造化された JSON に変換します。詳しくは cadlens.co をご覧ください。

インストール

まず、Cadlens ダッシュボードで API キーを取得してください。キーは cadl_ で始まり、ダッシュボードで無料で作成できます。

Claude Desktop / Cursor / Windsurf

MCP クライアントの設定に追加してください（例：macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）。

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

Claude Code CLI

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

---

開発（ソースからビルド）

npm install
npm run build

export CADLENS_API_KEY="cadl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
node dist/index.js

ツール

ツール	機能
cadlens_parse_file	ローカルの CAD ファイルをアップロードし、解析が完了するまでポーリングして（最大 5 分）、概要を返します。
cadlens_parse_url	URL から CAD ファイルをダウンロードし、parse_file と同様に解析します。
cadlens_get_job	ステータスを低コストで確認します（PENDING / PROCESSING / COMPLETED / FAILED）。
cadlens_get_result	解析済みの内容を取得します。mode は summary（デフォルト）、entities_by_type、entities_on_layer、full を指定できます。
cadlens_refresh_image_url	結果全体を再ダウンロードせずに、1 時間有効な署名付き PNG URL を再取得します。
cadlens_list_jobs	設定済みの API キーに対する、直近 100 件のジョブを取得します。
cadlens_delete_job	ジョブとその S3 アーティファクトを削除します。元に戻せません。

設定

環境変数	必須	デフォルト	備考
CADLENS_API_KEY	はい	—	CADLens ダッシュボードで作成します。
CADLENS_API_BASE	いいえ	https://api.cadlens.co/v1	ローカル開発の場合は http://localhost:3001/v1 を設定します。
WEBHOOK_PORT	いいえ	0（ランダム）	プロセス内の Webhook レシーバーのポートです。
WEBHOOK_PUBLIC_URL	いいえ	未設定	CADLens がローカルのレシーバーにアクセスできるよう、トンネル URL（ngrok/cloudflared）を設定します。設定すると、解析呼び出し時に Webhook が自動登録され、受信時にポーラーが処理を短縮します。
REQUEST_TIMEOUT_MS	いいえ	30000	CADLens 呼び出しの HTTP リクエストごとのタイムアウトです。

Webhook による処理短縮（オプション）

WEBHOOK_PUBLIC_URL が設定されている場合、parse_file / parse_url はアップロードと同時にプロセスごとの Webhook URL を登録します。Webhook ハンドラーはインメモリのジョブ状態キャッシュを更新し、ポーラーは HTTP GET の前にこのキャッシュを確認します。COMPLETED / FAILED を受信すると、ポーラーは早期に結果を返します。ツールの仕様を変えることなく、最悪の場合のレイテンシーをポーリング間隔 1 回分（約 1 秒）まで短縮できます。

トンネルの設定例：

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

開発

npm run typecheck
npm run lint
npm test
npm run smoke   # tools/list smoke test against built binary

プロジェクトスコープの Claude エージェント

このリポジトリには、.claude/agents/ に 5 つのエージェントが用意されています。

• cadlens-api-debugger — mcp-server-reference.md を使用して、原因不明の CADLens 4xx/5xx を診断します。
• mcp-tool-tester — ビルド済みサーバーに対して JSON-RPC を実行し、ツールの応答を検証します。
• mcp-tool-implementer — 既存の src/tools/* パターンに従って、新しいツールのひな形を作成します。
• cad-drawing-summarizer — MCP ツールを使って、CAD ファイルを自然言語で要約します。
• cad-layer-inspector — 解析済みの図面から、単一のレイヤーを詳しく調べます。

リンク

• Cadlens 公式サイト
• Cadlens API ドキュメント
• Cadlens の料金
• AI エージェント向け DWG パーサー
• npm パッケージ
• GitHub リポジトリ

---

GitHub トピック

このリポジトリを見つけやすくするため、次のトピックを追加してください： mcp mcp-server model-context-protocol ai-agents claude cad dwg dxf cad-api llm-tools engineering-api

---

ライセンス

MIT