SolidworksMCP

SolidworksMCP は、Windows COM API を介してライブの SOLIDWORKS セッションを制御するための、本番指向の Model Context Protocol サーバーです。

これは alisamsam/Solidworks-MCP のフォークであり、ツールを 82 から 143 に拡張し、図面、アセンブリ編集、板金、製造パッケージのエクスポート、ドキュメント参照トレースを追加しています。このフォークが追加するもの を参照してください。

現在のリリース: 6.5.31。このリリースは SOLIDWORKS 2026 SP2.1 で受け入れテスト済みであり、SOLIDWORKS 2025 に対する互換性ガードを保持しています。

ハイライト

• ネイティブなスケッチ、フィーチャー、ボディ、参照ジオメトリ、ビュー、プローブ、エクスポート操作。

• チェックポイント、不変条件、冪等性、予算、ロールバックを備えたトランザクション CAD プラン。

• 名前付きエンティティ、拘束、寸法、方程式、永続 ID、自由度解析を備えたパラメトリックスケッチ。

• 明示的なマージスコープ、クリアランス、干渉、境界ボックス、ボリューム検証を備えたマルチボディツール。

• シルエットと線画のための決定論的なラスタからスケッチへのパイプライン。GPU ベースのセグメンテーション、トポロジ保存、プリミティブフィッティング、逆ラスタ品質ゲートを含む。

• スクリーンショットのみの受け入れではなく、ネイティブなスケッチ/ボディエクスポートと較正された幾何学的比較。

• 検証済みのアクティブスケッチの Normal To と Fit to Screen。サーバーは、UI コマンドを信頼するのではなく、結果のカメラ行列とピクセル占有率を読み取ります。

• 図面ドキュメントをエンドツーエンドで: シート、ビュー、モデル注釈、手動寸法、ノート、バルーン、中心マーク、BOM テーブル。

• アセンブリ編集: コンポーネント、メイト、パターン、抑制、置換、爆発ビュー。

• ベースフランジからフラットパターン DXF までの板金、およびアセンブリ全体の STEP、DXF、PDF をエクスポートするワンコール製造パッケージ。

• ドキュメント検索と参照トレースを双方向で。プロジェクトフォルダ全体での使用箇所検索を含む。

• 構造化診断、モーダルダイアログ事前チェック、狭いスコープの Modify ウォッチドッグ、および有限回復ポリシー。

Related MCP server: solidworks-mcp

このフォークが追加するもの

このリポジトリは alisamsam/Solidworks-MCP のフォークです。アップストリームリリースは、スケッチ、ソリッドフィーチャー、ボディ、プローブ、ベクトル化、トランザクションレイヤーをカバーする 82 ツール を公開していました。このフォークはそれを 143 ツール に拡張し、テストスイートを 155 から 382 テスト に増やし、すべて合格しています。

追加された機能は、アップストリームプロジェクトがすでに確立した規律に従っています: COM の戻り値は信頼されません。すべての新しい操作は、結果の状態を読み戻します - 注釈数、コンポーネントリスト、抑制フラグ、面数、ディスク上のファイル - そして、API が変更を報告したときではなく、モデルが実際に変更を示さないときに失敗を報告します。

図面 (17 ツール)

アップストリームには図面ドキュメントのサポートがまったくありませんでした。このフォークは完全な詳細パスをカバーしています: create_new_drawing、add_sheet、activate_sheet、list_sheets、insert_drawing_view、insert_standard_views、insert_section_view、insert_detail_view、list_drawing_views、set_view_scale、insert_model_annotations、insert_bom_table、add_drawing_dimension、insert_drawing_note、insert_balloons、insert_center_marks、list_drawing_annotations。

ビューと注釈は、シート上に表示されたものを数えることで検証されます。CreateDrawViewFromModelView3 と InsertModelAnnotations3 はどちらも、作成されなかったビューと注釈に対して成功を報告します。

アセンブリ (14 ツール)

アップストリームはアセンブリを開くところで止まっていました。このフォークはコンポーネントとメイトの作業を追加します: insert_component、list_components、add_mate、delete_mate、list_mates、set_component_fixed、check_assembly_interference、delete_component、replace_component、set_component_suppression、pattern_components、explode_assembly、show_exploded、list_exploded_views。

板金 (6 ツール)

板金は、成果物がソリッドではなくフラットパターン - レーザーやタレットが消費する DXF - である唯一のパーツ分野です。create_base_flange はスケッチを板金ボディに厚み付けします。convert_to_sheet_metal は既存のソリッドを板金に変換します。これは、曲げられたブラケットの STEP には曲げ情報が含まれないため、インポートされたジオメトリが取らなければならない経路です。create_edge_flange はプロファイルスケッチなしでエッジからフランジを曲げます。set_flat_pattern は平坦化または折りたたみを行います。export_flat_pattern は DXF または DWG を書き出します。get_sheet_metal_info は、見積もりやネスティング実行に必要な厚さ、半径、K ファクター、フラットパターンの範囲を報告します。

ExportFlatPatternView は、フラットパターンの構築に失敗したパーツに対して成功を報告するため、エクスポートはディスク上のファイルに対して検証されます。フラットパターンフィーチャーは、表示名ではなく API タイプ名で見つけられます。表示名はローカライズされているためです。

製造パッケージ (1 ツール)

export_manufacturing_package は、ショップが実際に受け取るフォルダを 1 回の呼び出しで生成します: すべてのパーツとアセンブリの STEP、すべての板金パーツの DXF、各モデルの隣にある図面の PDF、および各パーツの材料と質量をリストした manifest.json。アセンブリをコンポーネントごとにウォークするため、20 パーツのマシンは 60 回ではなく 1 回の呼び出しで済みます。開かなければならなかったドキュメントはその後閉じられ、元のアクティブドキュメントが復元されます。

ドキュメント検索と参照 (3 ツール)

search_documents は、フォルダ内の SolidWorks ファイルを名前の断片とタイプで検索します。list_document_references は、ドキュメントが使用するものと、それらの各ファイルがまだディスク上にあるかどうかを報告します。find_where_used は逆の質問 - どのアセンブリと図面がこのパーツを使用しているか - に答えます。これは SolidWorks が直接答えることができません。ドキュメントは参照するものを記録し、参照されるものを決して記録しないためです。逆マップは、フォルダツリー内のすべてのアセンブリと図面の依存関係を読み取ることで構築されます。これは、GetDocumentDependencies2 がファイルを開かずに参照を読み取るため、手頃な価格でのみ可能です。

フィーチャー (5 ツール)

create_loft、create_rib、apply_draft、simple_hole、hole_wizard。それぞれにデッドフィーチャーガードがあります: ジオメトリを追加せずに成功を報告するフィーチャーは、ツリーに残すのではなく削除されます。

構成、プロパティ、パラメータ (15 ツール)

activate_configuration、list_configurations、list_custom_properties、set_custom_property、delete_custom_property、get_material、set_material、get_mass_properties、get_dimension、set_dimension、add_equation、set_equation、delete_equation、list_equations、rebuild_document。

ShowConfiguration2 は検証済みの嘘つきの 1 つです: アクティブ化されなかった構成に対して成功を返すため、アクティブな構成は後で読み戻されます。

ツールを超えて

• ツールスキーマは server.py から schemas/ パッケージに移動し、ファミリごとにグループ化されました。これにより server.py は 3819 行から 2300 行に削減されました。

• パッケージングメタデータ (pyproject.toml)、マルチギガバイトの PyTorch バックエンド用の別の vision エクストラ、およびスイートを実行する GitHub Actions ワークフロー。

• LICENSE は両方の著作権者とフォークが変更する内容を記録します。

要件

• Windows 10 または Windows 11。

• SOLIDWORKS 2025 または 2026、インストール済みでライセンス済み。

• Python 3.10 以降。Python 3.11 が受け入れテスト済みのランタイムです。

• パッケージ化された線画チェックポイント用の Git LFS。

• ディープベクトル化モードには NVIDIA CUDA 環境を強く推奨します。get_capabilities が実際のバックエンド状態を報告します。

サーバーは対話型の SOLIDWORKS プロセスを駆動します。ヘッドレス CAD カーネルではなく、未知のモーダルダイアログは人間が検査する必要があります。

クローンとインストール

クローンする前に Git LFS をインストールするか、後でモデルオブジェクトをプルしてください:

git lfs install
git clone https://github.com/aryesil/SolidworksMCP.git
Set-Location SolidworksMCP
git lfs pull

分離された Python 環境を作成し、パッケージをインストールします:

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .

基本インストールは、ディープシルエットベクトル化を除くすべてのツールをカバーします。その PyTorch バックエンドは vision エクストラにあります:

python -m pip install -e ".[vision]"

エクストラが分離されているのは、CUDA ホイールがほとんどのツールが触れないインストールに数ギガバイトを追加するためです。デフォルトのホイールがマシンの CUDA ドライバと一致しない場合は、最初に適切な PyTorch ビルドをインストールしてください。get_capabilities が実際にアクティブなバックエンドを報告します。

requirements.txt は、パッケージメタデータなしでインストールする人のために基本依存関係を引き続きリストしています。

MCP 構成

仮想環境の Python 実行可能ファイルを使用して、MCP クライアントをリポジトリのエントリポイントにポイントします:

{
  "mcpServers": {
    "SolidworksMCP": {
      "command": "C:\\path\\to\\SolidworksMCP\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\SolidworksMCP\\solidworks_mcp_server.py"
      ]
    }
  }
}

SOLIDWORKS を起動し、MCP クライアントを再起動または再接続してから、実質的なモデリング操作の前に get_capabilities と get_environment_status を呼び出します。

安定した互換性識別子

SolidworksMCP は公開プロジェクトおよび MCP ハンドシェイク名です。Python パッケージは solidworks_mcp のままで、設定されたツール名前空間は solidworks のままで、既存のアーティファクトスキーマは solidworks-mcp/... 識別子を保持します。これらの内部名は互換性契約であり、意図的に名前変更されません。

操作ファミリ

サーバーは、小さなネイティブ操作と高レベルの検証済みワークフローの両方を公開します。重要なファミリは次のとおりです:

• ドキュメントと環境: 作成/開く/保存/閉じる、機能、セッションメトリクス、モーダル状態検査、回復;

• スケッチ: 標準平面、平面フェース、正確なモデル座標輪郭、プリミティブ描画、パラメトリックスケッチ、寸法、拘束、方程式;

• フィーチャー: 検証済みの押し出し/カット、回転、スイープ、フィレット、面取り、シェル、ミラー、パターン、参照軸と平面;

• ボディ: 可視性、名前付け、外観、ボリューム、クリアランス、干渉、マルチボディ挿入ワークフロー;

• 検証: レイ/セクションプローブ、スケッチトポロジ、ネイティブジオメトリエクスポート、スケッチ間および較正された画像比較、ボディシルエット;

• ベクトル化: 選択可能なシルエット/領域/線画モード、ディープセグメンテーション、制御可能な近似、CAD コミット、逆ラスタ検証;

• 図面: シート、モデルおよび標準ビュー、セクションおよび詳細ビュー、モデル注釈、手動寸法、ノート、バルーン、中心マーク、BOM テーブル;

• アセンブリ: コンポーネントの挿入と削除、メイト、置換、抑制、コンポーネントパターン、爆発ビュー、干渉チェック;

• 板金: ベースフランジ、インポートされたソリッドの変換、エッジフランジ、フラットパターン状態、DXF/DWG フラットパターンエクスポート、板金パラメータ;

• 製造出力: パーツまたはアセンブリ全体の STEP、DXF、PDF のワンコールパッケージエクスポートとマニフェスト;

• ディスク上のドキュメント: 名前とタイプによるファイル検索、欠落ファイル検出付きの送信参照、フォルダツリー全体での使用箇所検索;

• 構成とパラメータ: 構成、カスタムプロパティ、材料、質量特性、寸法、方程式;

• オーケストレーション: トランザクション、宣言型 CAD プラン、セマンティックプリミティブ、モデルグラフ同期、アトミックエクスポートバンドル。

権威あるライブスキーマには MCP ツールディスカバリを使用してください。ツールの説明と get_capabilities はサーバーとともにバージョン管理されています。

安全規則

• 未保存ドキュメントの最初の変更の前に絶対 save_path を指定するか、allow_unsaved_document=true で使い捨て作業を明示的にオプトインしてください。

• success を実行の証拠として扱ってください。トポロジ、ボディ数、境界ボックス、ボリューム、許容差、および読み取り可能な独立したアーティファクトを検証してください。

• マルチボディカットとボスには scope_bodies と expected_merge_bodies を使用してください。

• 未知のダイアログを自動確認しないでください。認識された、操作スコープの寸法 Modify ダイアログのみがウォッチドッグによって処理される場合があります。

• ネイティブ MCP ツール座標は宣言されたユーザー単位、通常はミリメートルを使用します。生の SOLIDWORKS COM 座標はメートルを使用します。

• スケッチ操作後に盲目的な Ctrl+8 を呼び出さないでください。バージョン 6.5.31 はすでに安定したサイド/アップ方向と作業ジオメトリフィットを適用および検証しています。

ベクトル化モデル

決定論的な線画チェックポイントは solidworks_mcp/models/lineart/ の下にあり、Git LFS で保存されています：

• dexined_biped_v2.pt

• teed_biped_5.pt

それらの出典とライセンス表記は solidworks_mcp/models/lineart/LICENSES.md に記載されています。バイナリオブジェクトの代わりに小さな LFS ポインタファイルのみを含むクローンは不完全です。サーバーを起動する前に git lfs pull を実行してください。

SOLIDWORKS Autotrace/Picture to Sketch は対話型の PropertyManager 機能であり、サポートされている公開 API エントリポイントはありません。したがって、このサーバーは独自の決定論的なセグメンテーションおよび線画パイプラインを使用します。

設定

デフォルトのランタイム設定は solidworks_mcp/config.json に保存されています。マシン固有または機密性の高い上書き設定は config.local.json に保持してください。このファイルは Git によって無視されます。

注目すべきデフォルト設定は次のとおりです：

• SOLIDWORKS 実行ファイルとテンプレートの自動検出

• ユーザー単位としてのミリメートル

• 操作スコープの寸法ダイアログガード

• 制限付きのトランザクション/ランタイム制限

• チェックポイントディレクトリの自動管理

• INFO レベルのファイルログ

相対的な log_file 値はソースチェックアウトではなく %LOCALAPPDATA%\SolidworksMCP\ の下に書き込まれます。config.json 内の絶対パスも引き続きサポートされています。

テスト

リポジトリには決定論的なユニットテストおよび回帰テストスイートが含まれています：

python -m unittest discover -s tests -p "test_*.py"

このスイートは 382 件のテスト に合格します。これらのテストは COM 動作のライブ受け入れテストに代わるものではありません。別の SOLIDWORKS メジャーバージョンを認定する場合は、標準平面、平面フェース、既存スケッチのアクティベーション、ビューの復元、フィーチャー、トランザクション、ベクトル化、およびエクスポートもカバーする必要があります。

プロジェクト構成

SolidworksMCP/
|-- solidworks_mcp_server.py       MCP stdio entry point
|-- requirements.txt
|-- LICENSE
|-- solidworks_mcp/
|   |-- server.py                  MCP dispatch and handlers
|   |-- schemas/                   tool schemas, grouped by family
|   |-- tool_registry.py           high-level tool metadata
|   |-- vector_worker.py           isolated scientific worker
|   |-- config.py / config.json
|   |-- constants.py
|   |-- automation/                SOLIDWORKS COM implementation
|   |-- models/lineart/            Git-LFS checkpoints and licenses
|   `-- utils/
`-- tests/
    `-- test_v6.py                 unit and regression suite

ランタイムログ、キャッシュ、ローカルクライアント設定、チェックポイント、生成されたレポート、受け入れテスト成果物、および手動プローブは意図的にリポジトリから除外されています。

ライセンス

このサーバーは MIT ライセンスの下で配布されています。LICENSE を参照してください。パッケージ化されたモデルの表記は solidworks_mcp/models/lineart/LICENSES.md に別途保持されています。

このリポジトリは Samsaam Ali Baig による alisamsam/Solidworks-MCP のフォークです。元の著作権表示は保持され、ここでの変更は同じ MIT ライセンスの下でリリースされています。LICENSE には両方の著作権者が記録され、このフォークが追加する内容が要約されています。