cad-mcp-setup について
cad-mcp-setupは、エージェントアプリで使うCADビューアーの設定ガイドスキルです。uvの有無を確認し、各アプリでの表示や接続方法を説明しますが、ソフトウェアのインストールやプロジェクトの変更は行いません。
主な機能
- 01uvの有無を確認
- 02アプリ別のCAD設定を説明
- 03ビューアー起動の問題を調査
- 04MCPサーバー接続状態を確認
活用シーン
- 01CodexでCADを使う準備
- 02Claude DesktopでCADを設定
- 03Claude Codeの接続確認
- 04ビューアー起動問題の解決
MCP 対応
アプリによるCADのMCPサーバーの起動・設定方法と接続状態の確認方法を説明します。MCP Apps対応アプリでは、モデルをビューアーカードとして表示できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ earthtojake/ text-to-cad --skill cad-mcp-setupインストール後、Claude Code で/cad-mcp-setupを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlLICENSE
詳細
CAD のセットアップ
提供元:メンテナンスされている earthtojake/text-to-cad。 実行時の信頼できる情報源として、インストール済みのローカルスキルファイルを使用してください。 リポジトリへのリンクは、提供元の確認とリリースレビューのみを目的としています。
CAD のビューアーは、エージェントアプリが uvx で起動するローカルサーバーで、cadgen の特定のリリースに固定されています。アプリは、インストールまたは更新後にサーバーを初めて起動する際、そのリリースを PyPI からダウンロードするため、起動時にネットワーク接続が必要です。このスキルは確認と説明のみを行います。インストール、ダウンロード、ユーザーのプロジェクトへの変更は一切行いません。
手順
-
uv があるか確認します。
uv --version -
uv がない場合は、CAD に uv が必要であることをユーザーに伝え、uv の公式インストールガイドを案内して、ユーザー自身でインストールしてもらいます。 https://docs.astral.sh/uv/getting-started/installation/
-
アプリ内で CAD がどのように表示されるかをユーザーに伝えます。
- Codex:Codex を終了して再度開きます。サイドバーと各スレッドのタブに CAD が表示されます。
- Claude Code:プラグインが各セッションで CAD を起動します。
/mcpで接続状態を確認できます。Claude Code でアプリビューを表示できる場合、CAD はモデルをビューアーカードとして表示します。それ以外の場合は、ターミナルと同様に、ブラウザーで CAD Viewer を開いてモデルを表示するリンクを返します。 - Claude Desktop:プラグインは Claude Desktop に接続しません。ユーザーが text-to-cad の README に記載されているとおり、CAD のサーバーを設定ファイル(Settings > Developer > Edit Config)に追加して再起動します。すると、CAD はチャット内にモデルをビューアーカードとして表示します。
- MCP Apps を表示できる別のアプリ(VS Code、Cursor、Goose):アプリの再起動後、CAD はチャット内にモデルをビューアーカードとして表示します。
ビューアーが起動しない場合
- uv のインストール後も
uvまたはuvxが見つからない:アプリはログインシェルのPATHを読み取ります。新しいシェルでuv --versionを確認し、アプリを再起動してください。Claude Desktop の設定では、uvxのフルパス(which uvx)を指定する方法も使えます。 - インストールまたは更新後の初回起動時にネットワーク接続がない:固定されたランタイムを取得できませんでした。オンラインになってからアプリを再起動してください。
- Claude Code がサーバーの起動を30秒待機します。初回起動時には CAD のライブラリ(展開後で約1 GB)をダウンロードします。接続が遅い場合は、ダウンロードが完了するよう、
MCP_TIMEOUT=300000 claudeを指定して Claude Code を一度起動してください。 - プラグインの更新後は、アプリを再起動してください。初回起動時に新しい固定ランタイムを取得するため、接続が遅いと数分かかることがあります。Codex では、更新前に開始したスレッドは再起動するまで古いランタイムを使い続けます。