cad-compare-mcp 0.0.0-stage → 0.1.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,53 @@
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 printable reports 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
+ ## Tools
36
+
37
+ | Tool | Free | Pro | What it does |
38
+ |---|:-:|:-:|---|
39
+ | `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 |
40
+ | `fingerprint` | ✓ | ✓ | One STEP part → position-independent fingerprint, to recognise the same part under another name |
41
+ | `describe` | ✓ | ✓ | Version, capabilities and licence status |
42
+ | `compare_assembly` | | ✓ | Two assemblies → parts added, removed, renamed or replaced, quantities, moves, structure, and what changed in modified parts |
43
+ | `find_duplicates` | | ✓ | A folder → groups of files that are the same part (also when moved), and mirrored left/right parts |
44
+ | `render_diff` | | ✓ | PNG pictures of the differences (overview and close-up) with numbered markers |
45
+ | `export_report` | | ✓ | A printable HTML report of the comparison next to the files |
46
+
47
+ 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.
48
+
49
+ STEP files (.step, .stp) from any CAD system. Native CAD formats, drawings and meshes are not supported.
50
+
51
+ ## Terms
52
+
53
+ 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,236 @@
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
+ fast-deep-equal 3.1.3 (MIT)
56
+
57
+ MIT License
58
+
59
+ Copyright (c) 2017 Evgeny Poberezkin
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-uri 3.1.9 (BSD-3-Clause)
82
+
83
+ Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
84
+ Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
85
+ All rights reserved.
86
+
87
+ Redistribution and use in source and binary forms, with or without
88
+ modification, are permitted provided that the following conditions are met:
89
+ * Redistributions of source code must retain the above copyright
90
+ notice, this list of conditions and the following disclaimer.
91
+ * Redistributions in binary form must reproduce the above copyright
92
+ notice, this list of conditions and the following disclaimer in the
93
+ documentation and/or other materials provided with the distribution.
94
+ * The names of any contributors may not be used to endorse or promote
95
+ products derived from this software without specific prior written
96
+ permission.
97
+
98
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
99
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
100
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
101
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
102
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
103
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
104
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
105
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
106
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
107
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
108
+
109
+ * * *
110
+
111
+ The complete list of contributors can be found at:
112
+ - https://github.com/garycourt/uri-js/graphs/contributors
113
+
114
+ ------------------------------------------------------------------------
115
+
116
+ json-schema-traverse 1.0.0 (MIT)
117
+
118
+ MIT License
119
+
120
+ Copyright (c) 2017 Evgeny Poberezkin
121
+
122
+ Permission is hereby granted, free of charge, to any person obtaining a copy
123
+ of this software and associated documentation files (the "Software"), to deal
124
+ in the Software without restriction, including without limitation the rights
125
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
126
+ copies of the Software, and to permit persons to whom the Software is
127
+ furnished to do so, subject to the following conditions:
128
+
129
+ The above copyright notice and this permission notice shall be included in all
130
+ copies or substantial portions of the Software.
131
+
132
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
133
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
134
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
135
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
136
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
137
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
138
+ SOFTWARE.
139
+
140
+ ------------------------------------------------------------------------
141
+
142
+ zod 4.6.7 (MIT)
143
+
144
+ MIT License
145
+
146
+ Copyright (c) 2025 Colin McDonnell
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-to-json-schema 3.25.2 (ISC)
169
+
170
+ ISC License
171
+
172
+ Copyright (c) 2020, Stefan Terdell
173
+
174
+ Permission to use, copy, modify, and/or distribute this software for any
175
+ purpose with or without fee is hereby granted, provided that the above
176
+ copyright notice and this permission notice appear in all copies.
177
+
178
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
179
+ WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
180
+ MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
181
+ ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
182
+ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
183
+ ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
184
+ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
185
+
186
+ ------------------------------------------------------------------------
187
+
188
+ jose 6.2.12 (MIT)
189
+
190
+ The MIT License (MIT)
191
+
192
+ Copyright (c) 2018 Filip Skokan
193
+
194
+ Permission is hereby granted, free of charge, to any person obtaining a copy
195
+ of this software and associated documentation files (the "Software"), to deal
196
+ in the Software without restriction, including without limitation the rights
197
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
198
+ copies of the Software, and to permit persons to whom the Software is
199
+ furnished to do so, subject to the following conditions:
200
+
201
+ The above copyright notice and this permission notice shall be included in all
202
+ copies or substantial portions of the Software.
203
+
204
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
205
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
206
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
207
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
208
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
209
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
210
+ SOFTWARE.
211
+
212
+ ------------------------------------------------------------------------
213
+
214
+ @modelcontextprotocol/sdk 1.32.2 (MIT)
215
+
216
+ MIT License
217
+
218
+ Copyright (c) 2024 Anthropic, PBC
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.
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.1.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
+ }