cad-compare-mcp 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,55 @@
1
- # Temporary Holding Version
1
+ # CAD Compare for AI assistants (MCP server)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Compare STEP CAD files from Claude, Cursor or any other MCP client: are two parts identical, the same part moved or rotated, or different, and what changed (which hole, from which diameter to which, where). Assemblies, duplicates in a folder, pictures of the differences and reports with an interactive 3D view with CAD Compare Pro.
4
+
5
+ **Everything runs on your computer.** Files are read locally and never uploaded; the assistant only sees the comparison result. The only network request is the licence check (licence key and plug-in version, if you set a key).
6
+
7
+ ## Setup
8
+
9
+ Requires Node.js 20 or newer. Add the server to your MCP client, for example in Claude Desktop (`claude_desktop_config.json`), Cursor (`.cursor/mcp.json`) or Windsurf:
10
+
11
+ ```json
12
+ {
13
+ "mcpServers": {
14
+ "cad-compare": {
15
+ "command": "npx",
16
+ "args": ["-y", "cad-compare-mcp"],
17
+ "env": { "CAD_COMPARE_LICENSE": "ccp_…" }
18
+ }
19
+ }
20
+ }
21
+ ```
22
+
23
+ Claude Code:
24
+
25
+ ```sh
26
+ claude mcp add cad-compare -e CAD_COMPARE_LICENSE=ccp_… -- npx -y cad-compare-mcp
27
+ ```
28
+
29
+ The licence key is optional: without it you get the free tools. Pro keys are created on your account page at [cad-compare.com](https://cad-compare.com/ai/) (one per computer, revocable). The key is checked once and then works offline for up to 7 days.
30
+
31
+ Claude Desktop users can also install the one-click bundle (`cad-compare.mcpb`) from [cad-compare.com/ai](https://cad-compare.com/ai/).
32
+
33
+ Then ask, for example: *"Compare ~/parts/bracket_v1.step with ~/parts/bracket_v2.step: what changed?"*
34
+
35
+ You can also drag the two files into the chat. The server runs on your computer and cannot see files uploaded to the chat, so it looks up the files with the same names in your Downloads, Desktop and Documents (on macOS via Spotlight) and says which ones it used; if there are several, the assistant asks you.
36
+
37
+ ## Tools
38
+
39
+ | Tool | Free | Pro | What it does |
40
+ |---|:-:|:-:|---|
41
+ | `compare` | ✓ | ✓ | Two STEP part files → `same` / `moved` / `different`, alignment (moved, rotated, mirrored), volumes, deviations. With Pro also the changed features with their dimensions, and multi-body parts |
42
+ | `fingerprint` | ✓ | ✓ | One STEP part → position-independent fingerprint, to recognise the same part under another name |
43
+ | `describe` | ✓ | ✓ | Version, capabilities and licence status |
44
+ | `compare_assembly` | | ✓ | Two assemblies → parts added, removed, renamed or replaced, quantities, moves, structure, and what changed in modified parts |
45
+ | `find_duplicates` | | ✓ | A folder → groups of files that are the same part (also when moved), and mirrored left/right parts |
46
+ | `render_diff` | | ✓ | PNG pictures of the differences (overview and close-up) with numbered markers |
47
+ | `export_report` | | ✓ | An HTML report of the comparison next to the files: printable, with an interactive 3D view that works offline in any browser |
48
+
49
+ Results are JSON with documented fields (`cadver.diff/v1`, `cadver.fingerprint/v1`, `cad-compare.*/v1`); lengths are in millimetres. Errors come back as `{"error": "invalid_file" | "unsupported" | "license_required" | "exists" | "internal", "message": …, "hint": …}`; the hint tells the assistant what to do next.
50
+
51
+ STEP files (.step, .stp) from any CAD system. Native CAD formats, drawings and meshes are not supported.
52
+
53
+ ## Terms
54
+
55
+ CAD Compare is made by Wansu UG, Germany. [Terms](https://cad-compare.com/legal/terms/) · [Privacy](https://cad-compare.com/legal/privacy/) · Uses Open CASCADE Technology (LGPL-2.1) through replicad-opencascadejs, installed as a separate package.
@@ -0,0 +1,262 @@
1
+ Third-party software bundled in server.mjs
2
+
3
+ ajv 8.20.0 (MIT)
4
+
5
+ The MIT License (MIT)
6
+
7
+ Copyright (c) 2015-2021 Evgeny Poberezkin
8
+
9
+ Permission is hereby granted, free of charge, to any person obtaining a copy
10
+ of this software and associated documentation files (the "Software"), to deal
11
+ in the Software without restriction, including without limitation the rights
12
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13
+ copies of the Software, and to permit persons to whom the Software is
14
+ furnished to do so, subject to the following conditions:
15
+
16
+ The above copyright notice and this permission notice shall be included in all
17
+ copies or substantial portions of the Software.
18
+
19
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25
+ SOFTWARE.
26
+
27
+ ------------------------------------------------------------------------
28
+
29
+ ajv-formats 3.0.1 (MIT)
30
+
31
+ MIT License
32
+
33
+ Copyright (c) 2020 Evgeny Poberezkin
34
+
35
+ Permission is hereby granted, free of charge, to any person obtaining a copy
36
+ of this software and associated documentation files (the "Software"), to deal
37
+ in the Software without restriction, including without limitation the rights
38
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
39
+ copies of the Software, and to permit persons to whom the Software is
40
+ furnished to do so, subject to the following conditions:
41
+
42
+ The above copyright notice and this permission notice shall be included in all
43
+ copies or substantial portions of the Software.
44
+
45
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
46
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
47
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
48
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
49
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
50
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
51
+ SOFTWARE.
52
+
53
+ ------------------------------------------------------------------------
54
+
55
+ esbuild 0.28.2 (MIT)
56
+
57
+ MIT License
58
+
59
+ Copyright (c) 2020 Evan Wallace
60
+
61
+ Permission is hereby granted, free of charge, to any person obtaining a copy
62
+ of this software and associated documentation files (the "Software"), to deal
63
+ in the Software without restriction, including without limitation the rights
64
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
65
+ copies of the Software, and to permit persons to whom the Software is
66
+ furnished to do so, subject to the following conditions:
67
+
68
+ The above copyright notice and this permission notice shall be included in all
69
+ copies or substantial portions of the Software.
70
+
71
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
72
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
73
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
74
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
75
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
76
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
77
+ SOFTWARE.
78
+
79
+ ------------------------------------------------------------------------
80
+
81
+ fast-deep-equal 3.1.3 (MIT)
82
+
83
+ MIT License
84
+
85
+ Copyright (c) 2017 Evgeny Poberezkin
86
+
87
+ Permission is hereby granted, free of charge, to any person obtaining a copy
88
+ of this software and associated documentation files (the "Software"), to deal
89
+ in the Software without restriction, including without limitation the rights
90
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
91
+ copies of the Software, and to permit persons to whom the Software is
92
+ furnished to do so, subject to the following conditions:
93
+
94
+ The above copyright notice and this permission notice shall be included in all
95
+ copies or substantial portions of the Software.
96
+
97
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
98
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
99
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
100
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
101
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
102
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
103
+ SOFTWARE.
104
+
105
+ ------------------------------------------------------------------------
106
+
107
+ fast-uri 3.1.9 (BSD-3-Clause)
108
+
109
+ Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
110
+ Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
111
+ All rights reserved.
112
+
113
+ Redistribution and use in source and binary forms, with or without
114
+ modification, are permitted provided that the following conditions are met:
115
+ * Redistributions of source code must retain the above copyright
116
+ notice, this list of conditions and the following disclaimer.
117
+ * Redistributions in binary form must reproduce the above copyright
118
+ notice, this list of conditions and the following disclaimer in the
119
+ documentation and/or other materials provided with the distribution.
120
+ * The names of any contributors may not be used to endorse or promote
121
+ products derived from this software without specific prior written
122
+ permission.
123
+
124
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
125
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
126
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
127
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
128
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
129
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
130
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
131
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
132
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
133
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
134
+
135
+ * * *
136
+
137
+ The complete list of contributors can be found at:
138
+ - https://github.com/garycourt/uri-js/graphs/contributors
139
+
140
+ ------------------------------------------------------------------------
141
+
142
+ json-schema-traverse 1.0.0 (MIT)
143
+
144
+ MIT License
145
+
146
+ Copyright (c) 2017 Evgeny Poberezkin
147
+
148
+ Permission is hereby granted, free of charge, to any person obtaining a copy
149
+ of this software and associated documentation files (the "Software"), to deal
150
+ in the Software without restriction, including without limitation the rights
151
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
152
+ copies of the Software, and to permit persons to whom the Software is
153
+ furnished to do so, subject to the following conditions:
154
+
155
+ The above copyright notice and this permission notice shall be included in all
156
+ copies or substantial portions of the Software.
157
+
158
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
159
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
160
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
161
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
162
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
163
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
164
+ SOFTWARE.
165
+
166
+ ------------------------------------------------------------------------
167
+
168
+ zod 4.6.7 (MIT)
169
+
170
+ MIT License
171
+
172
+ Copyright (c) 2025 Colin McDonnell
173
+
174
+ Permission is hereby granted, free of charge, to any person obtaining a copy
175
+ of this software and associated documentation files (the "Software"), to deal
176
+ in the Software without restriction, including without limitation the rights
177
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
178
+ copies of the Software, and to permit persons to whom the Software is
179
+ furnished to do so, subject to the following conditions:
180
+
181
+ The above copyright notice and this permission notice shall be included in all
182
+ copies or substantial portions of the Software.
183
+
184
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
185
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
186
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
187
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
188
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
189
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
190
+ SOFTWARE.
191
+
192
+ ------------------------------------------------------------------------
193
+
194
+ zod-to-json-schema 3.25.2 (ISC)
195
+
196
+ ISC License
197
+
198
+ Copyright (c) 2020, Stefan Terdell
199
+
200
+ Permission to use, copy, modify, and/or distribute this software for any
201
+ purpose with or without fee is hereby granted, provided that the above
202
+ copyright notice and this permission notice appear in all copies.
203
+
204
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
205
+ WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
206
+ MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
207
+ ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
208
+ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
209
+ ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
210
+ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
211
+
212
+ ------------------------------------------------------------------------
213
+
214
+ jose 6.2.12 (MIT)
215
+
216
+ The MIT License (MIT)
217
+
218
+ Copyright (c) 2018 Filip Skokan
219
+
220
+ Permission is hereby granted, free of charge, to any person obtaining a copy
221
+ of this software and associated documentation files (the "Software"), to deal
222
+ in the Software without restriction, including without limitation the rights
223
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
224
+ copies of the Software, and to permit persons to whom the Software is
225
+ furnished to do so, subject to the following conditions:
226
+
227
+ The above copyright notice and this permission notice shall be included in all
228
+ copies or substantial portions of the Software.
229
+
230
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
231
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
232
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
233
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
234
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
235
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
236
+ SOFTWARE.
237
+
238
+ ------------------------------------------------------------------------
239
+
240
+ @modelcontextprotocol/sdk 1.32.2 (MIT)
241
+
242
+ MIT License
243
+
244
+ Copyright (c) 2024 Anthropic, PBC
245
+
246
+ Permission is hereby granted, free of charge, to any person obtaining a copy
247
+ of this software and associated documentation files (the "Software"), to deal
248
+ in the Software without restriction, including without limitation the rights
249
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
250
+ copies of the Software, and to permit persons to whom the Software is
251
+ furnished to do so, subject to the following conditions:
252
+
253
+ The above copyright notice and this permission notice shall be included in all
254
+ copies or substantial portions of the Software.
255
+
256
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
257
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
258
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
259
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
260
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
261
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
262
+ SOFTWARE.
package/package.json CHANGED
@@ -1,6 +1,33 @@
1
1
  {
2
2
  "name": "cad-compare-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.0",
4
+ "description": "Compare STEP CAD files: identical, moved, or different, and what changed. Runs locally; files never leave your computer.",
5
+ "mcpName": "com.cad-compare/cad-compare",
6
+ "type": "module",
7
+ "bin": {
8
+ "cad-compare-mcp": "server.mjs"
9
+ },
10
+ "files": [
11
+ "server.mjs",
12
+ "README.md",
13
+ "THIRD_PARTY_LICENSES.txt"
14
+ ],
15
+ "engines": {
16
+ "node": ">=20"
17
+ },
18
+ "dependencies": {
19
+ "replicad-opencascadejs": "1.1.0"
20
+ },
21
+ "homepage": "https://cad-compare.com/ai/",
22
+ "keywords": [
23
+ "mcp",
24
+ "mcp-server",
25
+ "cad",
26
+ "step",
27
+ "stp",
28
+ "compare",
29
+ "diff",
30
+ "mechanical engineering"
31
+ ],
32
+ "license": "UNLICENSED"
33
+ }