{"_id":"scanruler-mcp","_rev":"13-f012fd2f62bdd62f19a86599d8742d5b","name":"scanruler-mcp","dist-tags":{"latest":"0.6.4"},"versions":{"0.0.0-stage":{"name":"scanruler-mcp","version":"0.0.0-stage","_id":"scanruler-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"dist":{"shasum":"9e410fe9c4fc97064354ffa763c6a203fc7a4c0e","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-HDgZDf285142Lcc/dTmaUbDQyKozvavNOhMBpCEXhltkkfavXpinJVzkDoZfk2v8pHlzX+G3okBRMDtHSSrtZA==","signatures":[{"sig":"MEYCIQC2zN6xb9l/IgooLTzGb+RJUGuO0qWrk9agfTNgbJd6VQIhANGlOvKThjISkiY2lzkpXFUeBRQ9OyHBMNnpyOlIuiJK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":335},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"scanruler-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.1.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"5ace98489071212cf98d84e11589153f3c8e7905","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.1.0.tgz","fileCount":14,"integrity":"sha512-EVcKQ00iOl0tItbLYtnXfmKO+aa+5/80vCKhfS1fTctjMz7t37OzrY7NxRoXoMDYvVUitvUXA8wnlqaczg8d0w==","signatures":[{"sig":"MEUCIAomwXu/dUjwf+avP6hjDkj4/8CDpOILbMujBxSzY3e+AiEAsG6dosm5l9rE8JA2xJznTtJI34/fHMBhFRXnCEsUf2g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIFk4Hy5BKQsClfIopMIIX0WHPM6q2JK9i6umrTQ8Thl4AiBskJX99zEYwrBWe3hvZkWR9chMvChdXLy5DSZT3wm8NA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":180799},"type":"module","engines":{"node":">=20"},"gitHead":"893b36bec3d5c8b4ebddffd8815f0cd4f0f37baf","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.1.0_1791616460155_0.39887415022088635","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"scanruler-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.2.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"55c7c5c50efced677f8e8d07d6de0c97ba703f9e","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.2.0.tgz","fileCount":14,"integrity":"sha512-R/AlCRMyHrgbeLCKe/7d2lmpm/uJKlNEjuKEyyHbv+RDJC6yZZeq84bkFIkqz2O3zBa2Tli24xLf+1l3pH50mA==","signatures":[{"sig":"MEQCIDZ5yC8xoVNIJGglEehHno++yDhJJyyOOHD2N2jqG9EJAiBIidenYeyZuhQwG32RL9/91EM2yqphj4nVH3GC0yGFIg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD7Dj64Ljs2H5MM0Y209NHK4whMTuHbnwaCjB7+gbNjXwIhANOG/m9oG10abh0CYbQS+lYoDTIPcLEaNi3iJ6W7s1Ch","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200555},"type":"module","engines":{"node":">=22"},"gitHead":"409d6a2d59191b51bdc2861219e3d49d82d89190","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.2.0_1791815286210_0.0811725060468127","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"scanruler-mcp","version":"0.3.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.3.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"9570ba879199129d08804b8370a0f219431e7e81","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.3.0.tgz","fileCount":16,"integrity":"sha512-vceyN10vbTtzIGlW4eMAlevzsnd1iPxs0IB/q9FkfcZkg5yabmP0eOohxfl5FulH0M2Cugi5RCsKdnsF9Y6jDQ==","signatures":[{"sig":"MEUCIQCAVlF7bbzrKYQWzUmVm837/eGvfPnQqUkAQsJrhThLNwIgBpm8yOKT+GCGHkmcyhKyWt3i0YLURqCF0/ph+h/uPPI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIG+YxxxUtn48CaLhujd5rCcQZEyBkwbVHnswaZSUzrGxAiEA2VEyCiHTaKcjiNDAtUPiRRNA01Ep+aZq5WrAzq9hRz4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":277971},"type":"module","engines":{"node":">=22"},"gitHead":"55152eace510a8a4414bbd0ca97831bbfc8eb813","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.3.0_1792395135123_0.5178639963530043","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"scanruler-mcp","version":"0.4.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.4.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"41436240e22613dd23e715d1dddaf52497cb88c0","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.4.0.tgz","fileCount":17,"integrity":"sha512-GWprq8clCI7nuz4MVu8XhYKIp3lavLVUNqIM1mrA6r0VlxNVWzOjspPBkyAformEaDLOZYh/yz0Bm++v7TQ2vQ==","signatures":[{"sig":"MEUCICqpXZT6p4Tm3EWuBPjRqwJ5RRocpniwl70KcIeiKltZAiEAzfGcsnS2DjeGKdBdcq1/BvbcxfBrWZvO2eIgY0qwXQ8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIH9REgOnf11iQwfzpvrPe+2Y2nNlI6ReMXAIHvFFvMj5AiEAwtf+RtQxgv+91hBTuOvXZmu0cvHEB8BER+3V0O8CxyQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":406433},"type":"module","engines":{"node":">=22"},"gitHead":"10de0d0b1c4073bf1ed08609a1a13443fc84b479","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.4.0_1792745046190_0.7581492791797131","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"scanruler-mcp","version":"0.4.1","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.4.1","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"51df8b95d75f6c84ba5b756176004352cf60572c","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.4.1.tgz","fileCount":17,"integrity":"sha512-3TLEbJ6kkivZzoSx4o9z0Bl0G+GL09NguWFOYVjJIFjyI2AKDCNSZnQLCPD/U+7uq9QXhpAZXGe3v7JDYqawTQ==","signatures":[{"sig":"MEUCIEBs+xlEyh8JNug69Ij/EuE8M4gYGqjVdNdq6clNegpDAiEA8yRMuKIVVX0UB7avou1s3LKBp3aGlcCBDgtoSjCrsIo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHPIr/9A4AWGIzLs0pqIjwPkXFEDFraSFvfoYut3PqPEAiBMnRCcdwRfBQc8eIq2OsCWHyRcaoWlS+NynwNOOhyvKQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":408314},"type":"module","engines":{"node":">=22"},"gitHead":"4d0ffce169855ea627bb023daa3032123d487173","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.4.1_1792746446812_0.6978058640361722","host":"s3://npm-registry-packages-npm-production"}},"0.4.5":{"name":"scanruler-mcp","version":"0.4.5","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.4.5","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"308f87a923630169f847df19adab0df92fa1d8db","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.4.5.tgz","fileCount":17,"integrity":"sha512-LnIU1JJBzq19gy1agC2AFgOYVnZC6V+3hXEoy34h/XeAfAvewKWXtFvXJ/ilRaoJ+uWtaZ06j/5jV3fTkGY+mg==","signatures":[{"sig":"MEUCIQDb/6/RaBRLC5hQC3fy0AGX0EcPx64JL7/dkUW6NX5EpAIgD7VWM7/Fk1l6Flk9kT5I7O3jdAXdGc5C1S3piCm6/ls=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDU+wcbgpo2XFP+M6gJt/USAWAondh7dBfbOWa1eTLHJgIgFCzzW3/1z7zUTSvXYuWi56E4Oj5D5p3m0gaLkDPxAc0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451929},"type":"module","engines":{"node":">=22"},"gitHead":"c93eadd6cd06726da8e07f0ff9926fc2380d4574","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.4.5_1792999546614_0.7547291314477911","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"scanruler-mcp","version":"0.5.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.5.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"523a371b7e84c0d36c9a57ba090e8b507e78fa3a","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.5.0.tgz","fileCount":17,"integrity":"sha512-Wa+4ac92kULTP8KPGaqLxxR/qhCXQM2pGBZ/OkNp5lGVBEgy2845MQvrLG234jNRPZ1jB5hp39LzNMgldZGDPw==","signatures":[{"sig":"MEQCICRqyes2py4pQ/oGu2aUMIANAofLc7usAc3t/LDQaIEPAiB+xY4mYi/K/iIHRznhyxPbf6B01leVk0fo/Aqm0LJouw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEF/jPZu8TPgJIwGABdy84CobE5eEX32YGYSaK9ALXnBAiEAyRknBQGk01OUDpj+6y/6wP6v3wfpw3FkQ138wFh4BEo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":454234},"type":"module","engines":{"node":">=22"},"gitHead":"43ac1de176a9e27cf3b38a8809774238875ca4ec","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.5.0_1793196543603_0.8243243943630177","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"scanruler-mcp","version":"0.6.0","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.6.0","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"3ec233102cc3e0c4c2b388b4a71eeb57aba3ad0b","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.6.0.tgz","fileCount":17,"integrity":"sha512-PniIMPLvUlY0dxSBrFhEK5WgWuwjRFArMvif0B9BJRuTQmGHs5Hdw4bFp4qLRUo7clC5GTBLiYcfj2hTrUoWzA==","signatures":[{"sig":"MEYCIQDaJ96qn03shs5znWrXUQ5znemqAKcNZIPqCy5jr0EfDgIhAN7RebYtgzcryYnL1tJFP0KpCOKFaOQgeNIMH9nfEbVV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDqfd2aZ5OKgk2UZVYCbqdwkhYRXuXrgLTOc3W6cdtHVQIhANpVNYdBt9lz6gZraHQllSIZHeO9bQP5XloKkxqgJ9i5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":439256},"type":"module","engines":{"node":">=22"},"gitHead":"bd85e2bb9af38d867ec0a2a63e4eae644dbb6f8c","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.6.0_1793460292366_0.12074190323398759","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"scanruler-mcp","version":"0.6.1","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.6.1","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"20a35a04a82d0572936a3e3a8ee2bd2e5fbc47a5","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.6.1.tgz","fileCount":17,"integrity":"sha512-9v6W29M69zhgEyFiUQ+WRygLRQwr5rf+D17bnqbI5rFyLKnIPCgHquQj58gV73X3eX6qHF0CM6M4Lp8hYlNr2w==","signatures":[{"sig":"MEQCIHPmaMCIJNxVs5J324z9bN56+XsHim2lWQL3vT0kmT6JAiBBYkoFO053UVuKRB4Lpz2IRnAjpFXO3w0zZPfFJWVLJw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCui9V0EF/XpIW/Qrt03DKDu9xONo1oAPLqpE8K0OMdsQIhAK2ccyJQIg/gfCDeBHHxUhE/f4Ni91Vmbrvy6nqXK4ph","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":446073},"type":"module","engines":{"node":">=22"},"gitHead":"5546218657137fa48208f6e658497aed593ce4aa","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.6.1_1793540045522_0.8297286018965758","host":"s3://npm-registry-packages-npm-production"}},"0.6.2":{"name":"scanruler-mcp","version":"0.6.2","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.6.2","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"fb1b4859efe6d8c86cb2773bc730dfcf50308ce4","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.6.2.tgz","fileCount":17,"integrity":"sha512-q44H42JUil2BExDDWy1+oNZLk5OkOu+/lHNNNp1Tvb2chpqiaAdYnNuOXF1SZM+37OEgl3J5EVKl/2C/NqEdcw==","signatures":[{"sig":"MEUCIDiO67D3Fg/rDc0gGY3uHBWT+iNDZXW7oHtMXLv+uuFWAiEA8XKwJF+4WroNhx5kH0kjYmDa1HOOPSsogawJOwYMyIQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIGHCvzSRMnNK6J+02R3wuCVLP9B5l3pCM/t6BbpgmqQAAiEAl6DsXlaZoR7i1MdrNQVQ5rNoI6JD4X80/Zsm0VfXbzk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":476180},"type":"module","engines":{"node":">=22"},"gitHead":"3035876d8d193294f20f4aafdcbcf7addcc68e6c","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.11.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.6.2_1794162110028_0.923092843656129","host":"s3://npm-registry-packages-npm-production"}},"0.6.3":{"name":"scanruler-mcp","version":"0.6.3","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","_id":"scanruler-mcp@0.6.3","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"homepage":"https://scanruler.com/","bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"dist":{"shasum":"b1ca14a9f5a0e6f476dc3f8a3336b8381bf40f04","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.6.3.tgz","fileCount":17,"integrity":"sha512-fdV6XDvpa8jOM/cxgfLHsD52oiHC/bwmsY9omgWXCGOqXLt0JTkbz8l1I4c5myeGbRMF1BjTaIEG6lkfnvfo8w==","signatures":[{"sig":"MEUCIGoU/In/IF0YAsJNLKUtqyIywnIcZ/NJv4FK4LoRABWqAiEAtZQYkKyaVUyMpUWtnrTsjuhaQBHesD9o4ASe3Zgf/rQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD6LpPRP5bynS7v7QzuPq/YYUJSGIg0lYTTpzUcMB28wAIhAKPoUzAU5kLIc9fke1YmUjj3kiMewS7iv3/PavNJbYop","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":476324},"type":"module","engines":{"node":">=22"},"gitHead":"d52e8a8ca9c7fa2ec3b4102e1339fc4da41f14e0","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.20.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"_nodeVersion":"26.13.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/scanruler-mcp_0.6.3_1794253235401_0.2772248727035599","host":"s3://npm-registry-packages-npm-production"}},"0.6.4":{"_id":"scanruler-mcp@0.6.4","bin":{"scanruler-mcp":"bin/scanruler-mcp.js"},"bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"dist":{"shasum":"badfa6395dfdadf652ad43a9841b0d55543cf552","tarball":"https://registry.npmjs.org/scanruler-mcp/-/scanruler-mcp-0.6.4.tgz","fileCount":17,"integrity":"sha512-COzSP3n6ecJdliDU50A1BpMziiCWd46f40OQBuZAaW0We2hhndeop3Q8aySj4G6q2mPwgjSCVjsa894RI8dUOQ==","signatures":[{"sig":"MEUCIEj/7P7qxHpiCAjVSzEwIskiWxCWYPcbjaBeFfO6YarBAiEA6bxoansMB8qDPTrPhJnsG5oKelCNbkT/diGEbmohQTw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFi3jS23PRxPEp5vk5G5WtWESJaWnqulm+Jzc24TV5nNAiEA21qiKphRr3IDJihN8UutWI1+kcF1bXWC638A0vwFxOM="}],"unpackedSize":477485},"name":"scanruler-mcp","type":"module","author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"engines":{"node":">=22"},"gitHead":"507a334caefe58f32e4169ec22fdf87dd10e1900","license":"AGPL-3.0-only","scripts":{"test":"node --test","start":"node bin/scanruler-mcp.js"},"version":"0.6.4","_npmUser":{"name":"cnckitchen","email":"stefan@cnckitchen.com"},"homepage":"https://scanruler.com/","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"_npmVersion":"11.20.0","description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","directories":{},"maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"_nodeVersion":"26.13.0","dependencies":{"ws":"8.22.0","@modelcontextprotocol/sdk":"1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/scanruler-mcp_0.6.4_1794339127038_0.9332367395833987"}}},"time":{"created":"2026-10-10T07:13:02.619Z","modified":"2026-11-10T19:32:07.369Z","0.0.0-stage":"2026-10-10T07:13:02.619Z","0.1.0":"2026-10-10T07:14:20.251Z","0.2.0":"2026-10-12T14:28:06.299Z","0.3.0":"2026-10-19T07:32:15.247Z","0.4.0":"2026-10-23T08:44:06.348Z","0.4.1":"2026-10-23T09:07:26.898Z","0.4.5":"2026-10-26T07:25:46.698Z","0.5.0":"2026-10-28T14:09:03.726Z","0.6.0":"2026-10-31T15:24:52.473Z","0.6.1":"2026-11-01T13:34:05.654Z","0.6.2":"2026-11-08T18:21:50.147Z","0.6.3":"2026-11-09T19:40:35.501Z","0.6.4":"2026-11-10T19:32:07.199Z"},"bugs":{"url":"https://github.com/CNCKitchen/scanruler/issues"},"author":{"url":"CNC Kitchen","name":"Stefan Hermann","email":"stefan@cnckitchen.com"},"license":"AGPL-3.0-only","homepage":"https://scanruler.com/","keywords":["mcp","model-context-protocol","3d-scan","metrology","scanruler"],"repository":{"url":"git+https://github.com/CNCKitchen/scanruler.git","type":"git","directory":"mcp"},"description":"Drive ScanRuler, the 3D-scan measuring tool, from an AI agent: a local MCP server that reaches the ScanRuler tab open in your browser.","maintainers":[{"name":"cnckitchen","email":"stefan@cnckitchen.com"}],"readme":"# scanruler-mcp\n\nDrive [ScanRuler](https://scanruler.com/), the browser tool for measuring 3D\nscans, from an AI agent. This is a [Model Context Protocol](https://modelcontextprotocol.io)\nserver: the agent starts it and calls its tools; the ScanRuler tab open in\nyour browser connects to it over `127.0.0.1` and runs each call there, in\nfront of you. Every step the agent takes is one step of the tab's undo\nhistory, so you can take any of it back.\n\nNothing goes anywhere but your own computer: the scan travels from your disk\nto your browser through this server, as it does when you open it yourself.\nWhat the agent reads — the figures, the report — goes to the agent's model\nprovider, like everything else it reads. The server's one request of its own\nasks npm, once a day, for its latest version (see *Staying current*).\n\n## Setting up\n\nYou need [Node.js](https://nodejs.org/) 22 or newer, and Chrome, Edge or\nFirefox.\n\n### 1. Add the server to your agent\n\n**Claude Code**\n\n```bash\nclaude mcp add --scope user scanruler -- npx -y scanruler-mcp@latest\n```\n\n`--scope user` has it in every project; leave it out for this one only.\nExports the agent makes land in the folder Claude Code was started in,\nunless the agent names a path.\n\n**Codex** — the CLI, the IDE extension and the app share one setting:\n\n```bash\ncodex mcp add scanruler -- npx -y scanruler-mcp@latest\n```\n\nor, in `~/.codex/config.toml`, with room for the first start (npx fetches the\npackage) and for long calls — Codex gives a server 10 seconds to start and a\ncall 60 unless told otherwise:\n\n```toml\n[mcp_servers.scanruler]\ncommand = \"npx\"\nargs = [\"-y\", \"scanruler-mcp@latest\"]\nstartup_timeout_sec = 60\ntool_timeout_sec = 300\n```\n\n**Claude Desktop** — Settings → Developer → Edit Config, then in\n`claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"scanruler\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"scanruler-mcp@latest\", \"--out\", \"/Users/you/Documents/ScanRuler\"]\n    }\n  }\n}\n```\n\nClaude Desktop starts servers in a folder of its own, so give `--out` a folder\nfor the exports, and name files to the agent by their full path. Quit Claude\nDesktop after saving — File → Exit; closing the window leaves it running —\nand start it again. It starts the server twice, for its chats and for its\nCowork and Code sessions; the copy that starts first holds the port and the\ntab connects to it, and the other sends its calls through that one — see\n*Several agents* below.\n\n**Cursor** — `.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` for all:\n\n```json\n{\n  \"mcpServers\": {\n    \"scanruler\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"scanruler-mcp@latest\"]\n    }\n  }\n}\n```\n\n**From a clone of the ScanRuler repository**, to try a change: run\n`npm --prefix mcp ci` once, then use\n`node /path/to/scanruler/mcp/bin/scanruler-mcp.js` where the examples say\n`npx -y scanruler-mcp@latest` — in Claude Code,\n`claude mcp add scanruler -- node /path/to/scanruler/mcp/bin/scanruler-mcp.js`.\n\n### 2. Let the agent open ScanRuler\n\nAsk the agent for something in ScanRuler — or just *\"Connect to ScanRuler\"*.\nWith no tab connected, it calls `scanruler_open`, which opens ScanRuler in\nyour default browser with the pairing in its address: the tab switches the\nconnection on with this server's port and token, and connects. The first\ntime, ScanRuler warns that what the agent reads goes to the agent and its model,\nnot only this computer, and connects once you accept. Then **Chrome and Edge**\nask whether scanruler.com may access \"apps and services on this device\" — allow\nit, that is this server. **Firefox** asks the same. The tab keeps the pairing,\nso this is done once per browser.\n\nWhen the default browser is not the one you use ScanRuler in, or the agent\nruns somewhere it cannot open one, pair by hand:\n\n```bash\nnpx -y scanruler-mcp@latest --pair\n```\n\nprints the port, the pairing token and a link. Open the link once in the\nbrowser you use ScanRuler in, or in ScanRuler go to ⚙ **Settings → Agents**,\nswitch on **Local agent connection**, and enter the port and the token. The\ntoken is made on the first run and kept in your config folder\n(`%APPDATA%\\scanruler-mcp` on Windows,\n`~/Library/Application Support/scanruler-mcp` on macOS,\n`$XDG_CONFIG_HOME/scanruler-mcp` elsewhere, `~/.config/scanruler-mcp`\nwithout it). `scanruler_status` hands out the same\nlink.\n\nA chip in ScanRuler's top bar says where the connection stands: **listening**\nwhile the agent's server is not running, **connected**, or **turned away**\n(a wrong token, or another tab connected already — the server takes one tab\nat a time). If you denied the browser's question, allow *Local network\naccess* for the site in the site settings (the icon left of the address) and\nreload. **Safari** does not let a page from the web reach the computer it\nruns on at all; use `--serve` below.\n\n### Staying current\n\nWith `@latest` in the setting, npx asks npm for the newest version at every\nstart and fetches it when there is one, so quitting the app and opening it\nagain updates the server. Offline, npx starts the copy it has; on a network\nthat turns connections away rather than having none, it tries for about a\nminute first. (npm 9.7 and newer treat a bare `scanruler-mcp` the same way.)\n\nThe server also keeps itself current — for a setting without `@latest` on an\nolder npm, or a copy installed with `npm install -g`. Once a day, in the\nbackground, it asks npm's registry (registry.npmjs.org, or the one npm is set\nto) for its latest version: that one request, given 2 seconds. When there is\na newer one, npm fetches it into its cache, and the next start runs it in\nplace of the old copy, without waiting on the network. What it found is kept\nin `update.json` in the config folder, and `scanruler_status` says it:\n`server.version`, `server.latest`, and `server.handedOffFrom` when an older\ncopy started this one. A version pinned in the setting\n(`scanruler-mcp@0.4.0`) is left as it is, and so is a copy run from a clone\nof the repository. To turn it off: `--no-update`, or\n`SCANRULER_MCP_NO_UPDATE=1`.\n\nWhen ScanRuler shows **Your ScanRuler connector is out of date**, the server\nyour app starts is older than the page needs: ask your agent to update it, with\nthe sentence the banner gives you to paste, or change the setting to the\n`@latest` line it shows. Then quit the app completely — not just its window —\nand open it again.\n\nWhen the page is updated while the app runs, the tools the app was given are\nthe old page's, and `scanruler_status` says so (`tools.stale`, with what was\nadded, removed and changed). A new chat does not bring the new ones: Claude\nDesktop keeps one server for as long as it runs and does not list the tools\nagain when told they changed. Quit the app completely — in Claude Desktop,\n**Quit** from its tray or menu-bar icon, not just closing the window — and open\nit again; the server it starts lists the page's current tools. Until then,\n`scanruler_batch` runs any of the page's tools by name, new ones included.\n\n### Several agents\n\nAny number of copies of the server can share the tab. The first to start\nholds the port and the tab's connection; one that finds the port taken\nconnects to that one, with the same token, and sends its calls through it.\nWhen the copy holding the port stops, another takes the port over, and the\ntab — which keeps trying — connects to it within ten seconds.\n`scanruler_status` says which this copy is (`server.role`: `holder`,\n`relay` — with the holding copy's version as `server.holder.version` —, or\n`none` with `server.error` saying why). The page judges the copy holding\nits connection: when that one is out of date, a relaying copy's status says\nso, and quitting the app that started it lets a current copy take over. Copies with different\ntokens cannot share a port: give them the same `SCANRULER_MCP_TOKEN`, or\neach its own `--port`. Changes from several agents run one after another in\nthe tab, each one step of the same undo history.\n\n### Serving the app yourself\n\n```bash\nnpx -y scanruler-mcp@latest --serve /path/to/scanruler/dist\n```\n\nserves a built ScanRuler (`npm run build` in a clone) at\n`http://127.0.0.1:7317/` from the same port the tab connects to — for Safari,\nfor working offline, and for your own build. A page from there needs\nno browser permission, and `--pair` then gives a link to it.\n\n### Without a browser (headless)\n\n```bash\nnpm run build:engine                       # in a clone of ScanRuler\nnpx -y scanruler-mcp@latest --engine /path/to/scanruler/dist-engine/engine.mjs\n```\n\nruns ScanRuler itself inside the server, with no browser and no tab: the\nengine is a build of the app for Node, `dist-engine/engine.mjs`, which the\nserver loads from where it is and names nothing in. `--headless` takes the\nengine built in the checkout the server is part of; `SCANRULER_ENGINE` gives\na path as `--engine` does. There is no scan, no viewport and nobody\nwatching, so only the commands that run without a page are tools —\n`session_state` and `history_undo`/`history_redo` in the app itself, and\nwhatever a build of ScanRuler marks to run so; a tool that needs the page\n(`view_render`, `scan_open` …) answers `unavailable`, naming the page mode.\nFiles still go by `path`. The server's instructions say it runs headless,\n`scanruler_status` says `backend: \"headless\"` and where the engine is, and\n`scanruler_open` has nothing to open. Each server is a session of its own —\nan agent's subagents can each start one and work side by side, sharing\nnothing — and what the app logs goes to stderr with the server's own lines.\n`--tools compact` works headless too: the server's own tools are listed, and\nthe engine's are read through `scanruler_tools` and run through\n`scanruler_batch` (see *Small local models*).\n### Small local models\n\nListed in full, every command the tab offers is a tool of its own: over a\nhundred tools and 50k tokens of schema, all read before the conversation starts. A\nfrontier model takes that in its stride. A local model with a 128k window\nruns out of room within a few tool rounds, and picks less reliably among so\nmany. For such a model, start the server with `--tools compact` (or set\n`SCANRULER_MCP_TOOLS=compact`). It then lists about a dozen tools, a few\nthousand tokens: the server's six, `scanruler_tools`, and the tab's tools\nthat return a picture — `view_render`, `section_render`, `flat_render` and\n`scan_heightmap`.\n\n- `scanruler_tools` with no arguments lists the tab's tools, a name and a\n  line each, about 1.5k tokens for a hundred. With `names` it gives those\n  tools' full definitions, as the full list has them, up to 20 at a time.\n  Names it does not know come back in `unknown`.\n- The model runs the tools through `scanruler_batch`, one call as a batch of\n  one. A refused call comes back with the tab's error code and what was\n  wrong, so the model can try again with corrected arguments. A client that\n  lets the model call a tool it was not given can call them directly too.\n- The tools that return a picture are listed so the model calls them\n  directly and sees the picture. In a batch a picture is not shown: it is\n  written to a file, the call's `path` or a new file in `scanruler-work` in\n  the open scan's folder (the output folder, `--out`, while no scan or\n  project was opened from one), and the call's result names it and the\n  folder. A tab that connects with\n  another picture tool has the client list the tools again.\n\n**LM Studio**: add `--tools` and `compact` to the server's arguments as two\nseparate entries. In `mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"scanruler\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"scanruler-mcp@latest\", \"--tools\", \"compact\"]\n    }\n  }\n}\n```\n\n**Codex** with a local model:\n\n```bash\ncodex mcp add scanruler -- npx -y scanruler-mcp@latest --tools compact\n```\n\nor `args = [\"-y\", \"scanruler-mcp@latest\", \"--tools\", \"compact\"]` in\n`~/.codex/config.toml`.\n\n### Fewer tools\n\nAn agent whose task stays in one or two workspaces carries the tools of\nevery other in each turn. `--tools` also takes namespaces — the part of a\ntool's name before its first underscore: `scan`, `section`, `view`,\n`element`, `align`, `deviation`, `flat`, `thickness`, `dimension`, `export`,\n`session`, `guide`, `project`, `history`, `report`, `workspace`, and what a\nconnected tab adds. Written with a leading `-` each, they are the namespaces\nto leave out: `--tools=-flat,-thickness,-dimension` (with the `=`: a value\nstarting with a dash is refused otherwise) lists everything but the\n2D sheet, the wall thickness and the dimension tools. Written plain, they are\nthe namespaces to list: `--tools scan,element,view,session,guide` and nothing\nelse. The two forms do not mix, and the server's own tools (`scanruler_*`)\nare listed either way, every listed command a tool of its own as in `full`.\nThe list is fixed when the server starts and never changes mid-chat, so\ngive it to the agent whose work is known — in the agent's config, or\n`SCANRULER_MCP_TOOLS=-flat,-thickness,-dimension`. A tool left out is\nunknown to the client: it is not listed, and a call to it by name answers\n`unknown_command`. A namespace the tab does not have is accepted — a tab\nmay add one — and the server says so on its stderr when a tab connects.\n\n## Options\n\n| Option | |\n|---|---|\n| `--port <n>` | The port the tab connects to; 7317 unless given. Also `SCANRULER_MCP_PORT`. |\n| `--out <dir>` | Where exports go when a tool call names no path; the folder the server was started in otherwise. |\n| `--serve <dir>` | Also serve a built ScanRuler from `<dir>`. |\n| `--allow-origin <url>` | Let a ScanRuler tab from another address connect — a self-hosted copy. Repeatable. scanruler.com and any page on this computer are always allowed. |\n| `--app <url>` | The ScanRuler address the pairing link opens. |\n| `--engine <file>` | Run ScanRuler headless in the server, from an engine built with `npm run build:engine` — no tab. Also `SCANRULER_ENGINE`. |\n| `--headless` | The same, with the engine built in the checkout the server is part of. |\n| `--tools <mode>` | `full`, the default: every command the tab offers is a tool. `compact`: the server's own and the tab's tools that return a picture; the rest are read through `scanruler_tools` and run through `scanruler_batch` — see *Small local models*. Or namespaces, comma-separated — the part of a tool's name before its first underscore: `scan,element,view` lists those alone, `-flat,-thickness,-dimension` all but those, the server's own tools either way — see *Fewer tools*. Also `SCANRULER_MCP_TOOLS`. |\n| `--trace <dir>` | Write a line per tool call — tool, ms, bytes each way, error, whether the tab was hidden — into a new file in `<dir>`, for measuring a run; off unless given. `scripts/trace-summary.mjs` in the ScanRuler repository sums a run up. Also `SCANRULER_MCP_TRACE`. |\n| `--trace-args` | With `--trace`, each call's arguments too; otherwise only their size. |\n| `--answer-within <s>` | Hold a call at most this many seconds, 45 unless given: a change, a batch or a long read still running then answers `{ queued: true, job, after }` and runs on, and `scanruler_wait` waits no longer either. A client, or a bridge between it and this computer, may cut a call at a minute; a cut call says nothing. `0` holds every call to its end. Also `SCANRULER_MCP_ANSWER_WITHIN`. |\n| `--no-update` | Do not keep the server current (see *Staying current*). Also `SCANRULER_MCP_NO_UPDATE=1`. |\n| `--pair` | Print the port, the token and the pairing link, and exit. |\n| `--version` | Print the server's version, and exit. |\n| `--help` | The options. |\n\n`SCANRULER_MCP_TOKEN` overrides the stored token; `SCANRULER_MCP_CONFIG_DIR`\nmoves the config folder.\n\n## Tools\n\nEvery command the ScanRuler tab offers is a tool, its name with dots turned\ninto underscores — `scan_open`, `element_fit`, `dimension_add`,\n`report_get`, `history_undo` and the rest; their descriptions say what each\nneeds and returns. The list is the tab's while one is connected — a build\nwith more commands lists more. Before a tab is there it is the list of the\nlast tab that connected, which the server keeps in its config folder\n(`tools.json`), or, the first time, the app's own; a client that lists the\ntools once, when it starts, sees them all that way, and one that listens is\ntold when the list changes. Seven more are the server's: `scanruler_status`\n(is a tab connected, which version, how to pair one, what the tab's\nsession holds — its scan, project, unsaved changes and work counted — the\ntime on this computer with its offset from UTC (`server.now`), and,\nwhen the client's list is out of date, which tools were added, removed or\nchanged since and which page it came from),\n`scanruler_open` (open ScanRuler in the default browser, paired, and wait\nfor it), `scanruler_wait` (until a tab is connected, or also idle),\n`scanruler_batch` (several of the tab's tools in one call, in order — a run\nof `scan_nearest` or `element_fit` calls — each answer in its place, stopped\nat the first refused unless told to go on), `scanruler_write` (a text\nfile — `.md`, `.txt`, `.csv` or `.json`, a report say — written in the folder\nthe server last opened a scan or a project from, and nowhere else: not into\nhidden folders, and not as a file agents and tools take instructions or\nsettings from, such as `CLAUDE.md`, `AGENTS.md` or `package.json`) and\n`scanruler_files` (that folder's files — name, size, kind — newest first), `scanruler_read` (a text file there, or an answer too long to carry wherever it was written, in parts: `{ text, offset, nextOffset, size }`, in bytes).\nThe folders are kept beside `tools.json` (`folders.json`), so a server\nstarted afresh still writes and lists there, and `scanruler_status` lists\nthem. With `--tools compact` only the tab's tools that return a picture are\nlisted; the rest are read through an eighth of the server's own,\n`scanruler_tools` — see *Small local models*. With `--tools` and a list of\nnamespaces, only the tab's tools of those namespaces, or all but those — see\n*Fewer tools*.\n\n- **Places on the scan** are `{ \"point\": [x, y, z] }` in millimetres — the\n  scan vertex nearest it is taken — or `{ \"vertex\": n }`. `scan_query` reads\n  the scan's own points: the vertices in a box or about a point, with their\n  normals, facing a way if asked; `section_get` a section's cut as\n  polylines, on the sheet and in the world.\n- **Files are paths.** `scan_open`, `deviation_open_reference`,\n  `flat_open_image` and `project_load` take `path`, a file on this computer;\n  the server reads it and streams it to the tab. The exports and\n  `project_save` take an optional `path` — a file, or a folder for the name\n  ScanRuler gives it — and the server writes the file there and returns where.\n  `scan_open` and `project_load` take a folder too, and open the one mesh,\n  or the one `.scanruler`, in it; with none or several the answer lists what\n  is there.\n  A tool that replaces the session (`scan_open`, `project_load`,\n  `session_reset`) takes `saveTo`: the session is saved as a project file\n  there first, then replaced — one call to keep what a tab someone left\n  holds.\n- **Arguments from a file.** `{ \"$file\": path }` anywhere in a tool's\n  arguments — an object of that one key — is replaced by the JSON the file\n  holds: a long list of stations a script wrote need not pass through the\n  conversation. With `\"$at\": \"loops.0.points\"` beside it, only the part of the\n  JSON at that path (keys and list indices by dots).\n- **Answers to a file.** A batch call with `to: \"outline.json\"` writes its\n  answer to that file, whole, and the batch's result says where and what the\n  answer holds — a long reading (an outline's loops, a height grid) fed on to\n  a later call by `$file` and `$at`, never carried through the conversation.\n  A file already there is replaced.\n- **Relative paths** — a batch's `file`, `$file`, a call's `to`, a file to\n  open, an output's `path` — are taken from the open scan's folder, or from the folder\n  the server was started in while no scan is open; `scanruler_status` gives\n  both (`server.relativeTo`, `server.cwd`). A picture or file written into a\n  folder is numbered past one already there (`-2`, `-3`), never written over.\n- **Long answers.** An answer past what one carries (40 k characters; a\n  guide 70 k — several guides asked for together come while they fit about\n  60 k, the rest named in `next`) is written whole to a JSON file in\n  `scanruler-work` in the open scan's folder — the server's own files, apart\n  from the person's, where an agent that may only read there can open it —\n  in the output folder (`--out`) while the scan open now was not opened from\n  a folder through this server. The answer says\n  `truncated: true`, the `file`, its short fields and the person's notes,\n  and its `note` says which folder it went to and how to ask for less — by\n  the command's own fields, as the command says it (a guide a section at a\n  time).\n- **Strings of JSON.** A client that sends a large nested value as a string\n  — a batch's `calls`, a call in it, or a call's `arguments` — has it read as\n  the JSON it holds; one that is not JSON is refused saying so, with nothing\n  run.\n- **A tab that reloaded.** A tab says who it is each time it loads. When a\n  tab that held work comes back as another — reloaded by the person, by the\n  dev server after an edit, or unloaded by the browser — the next answer\n  says so (`pageReloaded`), with the project file last opened or saved here,\n  which `scanruler_status` gives too (`lastProject`, kept in\n  `folders.json`). A tab older than the app it came from, which could not\n  load a part of it, answers `stale_page`, and the status says so from then\n  on (`page.stale`): save the project before the tab is reloaded.\n- **Pictures.** `view_render` comes back as an image the agent sees — the\n  3D view as the tab shows it, after `view_set` has turned it if asked — and\n  is written to a file only when the call gives `path`. `show` puts the\n  scan, the reference, the sections, the elements or the labels away for\n  the picture (`{ \"scan\": false }` shows what was built on the scan on its\n  own; a workspace adds keys of its own, which `view_set` lists), and\n  `frame` looks at a box or a place closely. `flat_render` is the 2D sheet's:\n  drawn as the sheet lies, with a grid ruled in millimetres and its values\n  at the margins, and a `map` from picture pixels to sheet places, so a\n  place read off the picture goes straight back as a place to click.\n  `section_render` pictures a section — or any plane, cut for the picture\n  alone — on its own sheet in millimetres: the scan's cut as points, what\n  the workspaces draw over it (a model's cut, a sketch's pieces with their\n  ids), and every point further than the tolerance from the model in red,\n  counted in the answer with the box round them.\n- **The 2D sheet** takes places as `[x, y]` in its own millimetres (pixels\n  before any scale), origin at the image's bottom-left corner, y up. An edge\n  is named by its chain number — `flat_edges` lists them, `flat_render`\n  writes them beside the edges, `flat_fit` takes them as `chains` — and a\n  pick answers where it snapped. `flat_objects` finds the separate parts on\n  an image and measures them; `flat_profile` reads an outline round a centre\n  or along an axis and counts its peaks — a knurl's teeth, say.\n- **Batches stand or fall whole.** `scanruler_batch` stops at the first\n  refused call — the answer names `failed: { index, tool, error }`. When\n  that call is a change, `rollback` (the default) undoes what the calls\n  before it changed, once the tab is idle: `undone` lists the steps taken\n  back, newest first (`history_checkpoint` and `history_restore` do the same\n  by hand across several calls). A refused read — a `section_get` of a\n  section that is not there — undoes nothing, and `kept` says what came\n  before it stands. A call refused `busy` (the tab working out something of\n  its own) is run again once, when the tab is idle, and says\n  `retried: \"busy\"`. `timings:\n  true` gives each call its `ms`, the batch its `total_ms`, and a change's\n  build the steps it played with their milliseconds (`result.steps.played`;\n  otherwise only how many it played and took up from a state held). The\n  notes left for the agent (`notes`), when a call answers with them, are\n  repeated at the batch's top as the last call gave them.\n- **Long changes.** Every tool that changes the session takes `wait`, and\n  so does a read the tab marks long (a comparison over whole bodies, say);\n  `wait: false` answers at once with `{ queued: true, job }` while the call\n  runs on, a batch too, and `scanruler_wait { for: \"job\", job }` gives its\n  answer when it is done. Still running at the answer limit\n  (`--answer-within`, 45 s), a call answers the same way with `after`, its\n  seconds; `scanruler_wait` waits no longer than that either and answers\n  `state: \"running\"` — call it again. The server keeps every change as a\n  job, so a call the client stopped waiting for keeps running and keeps its\n  answer: `scanruler_status` lists the latest jobs, running, done or failed.\n  The tab keeps a record of the commands run under each job too\n  (`session_recent`, the last hundred), so a server started afresh — whose\n  own jobs are gone — still answers `scanruler_wait` for a job of the copy\n  before it, from that record (`from` says so).\n  `scanruler_wait { for: \"idle\" }` waits for the changes still running too,\n  and answers `finished`: every change done or failed since it last said —\n  a failed one with its error, a batch with the call it stopped at — each\n  once, so a run of `wait: false` changes is read back in one call, and\n  `state`: `idle`, or `running` when the limit came first. A\n  change called on its own takes `timings: true` as well: its answer adds\n  the call's `ms` and the steps its build played. The tab answers what only\n  reads — `session_state` — while a change runs.\n- **A hidden tab.** A tab in the background, a covered or minimised window\n  or a locked screen is hidden to the browser, which then draws no frames\n  and slows timers to once a minute. Changes still run, and the waits a\n  command makes — for the session to settle, for the screen to follow —\n  look again on every change the session's stores see and draw their own\n  frames, so pictures still come. `scanruler_status` says `page.hidden`,\n  with a note: a browser that unloads background tabs (Chrome's Memory\n  Saver) may close it — keep the site among those always kept active.\n- **Results** are the session as the tab holds it afterwards, as JSON, in\n  millimetres and degrees, every number that is not whole kept to six\n  significant digits — except in an answer whose numbers are handed back\n  as inputs (a plane's frame, say), which keeps every digit. A refusal comes back as an error with a code —\n  `no_scan`, `busy`, `invalid_input`, `invalid_state` (something open in a\n  panel is in the way), `not_found`, `failed`, `unavailable`.\n\nA session might go: `scanruler_status`, `scanruler_open` if no tab is\nconnected, `scan_open`, `session_state` (the scan's bounding box says where\nthe part lies), `element_fit` twice, `dimension_add`, `report_get`,\n`view_render`.\n\n## How it works\n\nThe tab connects to `ws://127.0.0.1:<port>/`. Before that, a tab from the web\nfetches `http://127.0.0.1:<port>/scanruler-mcp`, which is what has Chrome and\nEdge ask for the permission a WebSocket alone never asks for. The server lets\nin a tab from scanruler.com, from this computer, or from an `--allow-origin`\naddress, that presents the pairing token — one tab at a time — and, beside\nit, other copies of itself that present the token, whose requests it passes\nto the tab (`src/relay.js`). Messages are\nJSON; a file travels as a binary frame right after the JSON that announces it,\nnever as base64 (`src/framing.js`, and `src/commands/framing.ts` in the app).\nEverything the server logs goes to stderr; stdout is the MCP channel.\n\n## Development\n\n```bash\nnpm ci\nnpm test        # node --test: framing, tool generation, the link, an MCP client end to end\n```\n\nThe app's browser check `node scripts/e2e-agent.mjs` (from the repository\nroot, against a running dev server) drives the whole path with the SDK's own\nMCP client. `src/commands.json` is the app's command list as of this version,\nfor listing the tools before a tab connects; the app's test\n`tests/mcpCommands.test.ts` keeps it current\n(`UPDATE_MCP_COMMANDS=1 npx vitest run tests/mcpCommands.test.ts`).\n\n## Licence\n\nAGPL-3.0-only, as ScanRuler — see [LICENSE](LICENSE).\n","readmeFilename":"README.md"}