@mylasertools/kerfscript-mcp 0.0.0-stage → 0.1.1

package/OFL.txt

@@ -0,0 +1,92 @@
+Copyright 2020 Braille Institute of America, Inc.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# KerfScript MCP
 
-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.
+An MCP server that lets AI assistants write and check
+[KerfScript](https://kerfscript.mylasertools.com) laser-cutting designs. The
+assistant can read the KerfScript docs and examples, find a design's settings
+and render it to SVG or DXF, so it can test its code before giving it to you.
+
+## Connect
+
+The hosted server needs no account or key:
+
+```text
+https://mcp.mylasertools.com/mcp
+```
+
+**Claude Code**
+
+```sh
+claude mcp add --transport http kerfscript https://mcp.mylasertools.com/mcp
+```
+
+**Claude** (desktop and web): Settings → Connectors → Add custom connector, and
+enter the address above.
+
+**Cursor**: add it to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "kerfscript": { "url": "https://mcp.mylasertools.com/mcp" }
+  }
+}
+```
+
+**VS Code**: add it to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "kerfscript": { "type": "http", "url": "https://mcp.mylasertools.com/mcp" }
+  }
+}
+```
+
+## Run it locally
+
+With Node.js 20 or newer, the same server runs on your computer and designs
+never leave it:
+
+```json
+{
+  "mcpServers": {
+    "kerfscript": { "command": "npx", "args": ["-y", "@mylasertools/kerfscript-mcp"] }
+  }
+}
+```
+
+In Claude Code:
+
+```sh
+claude mcp add kerfscript -- npx -y @mylasertools/kerfscript-mcp
+```
+
+## Tools
+
+| Tool                    | What it does                                                                   |
+| ----------------------- | ------------------------------------------------------------------------------ |
+| `kerfscript_docs`       | Reads the guides and the language reference                                    |
+| `kerfscript_examples`   | Finds examples by title or tag and returns their source                        |
+| `kerfscript_parameters` | Lists a design's settings with their ranges and choices                        |
+| `kerfscript_render`     | Renders a design to SVG or DXF, with its parts, sizes, layers and any warnings |
+
+Sizes are in millimetres. Text uses the bundled Atkinson Hyperlegible font.
+
+## Limits
+
+A design may be up to 64,000 characters, with up to 20 libraries of its own
+passed alongside it. It cannot read files or fetch anything from the network.
+Each render stops at 100,000 steps, 100 parts and 10 sheets. For bigger designs
+or other fonts, use the [KerfScript package](https://www.npmjs.com/package/@mylasertools/kerfscript)
+or its command line.
+
+The hosted server allows each client about 60 requests a minute and 1,000 a
+day. It does not store or log the designs you send.
+
+A render that succeeds does not mean the parts fit. Cut a test piece in your
+material before cutting a new design.
+
+## More
+
+- [AI assistants guide](https://kerfscript.mylasertools.com/docs/mcp/)
+- [KerfScript documentation](https://kerfscript.mylasertools.com/docs/)
+- [Issues](https://github.com/mylasertools/kerfscript/issues)
+
+Licensed under the [GNU AGPL 3.0](https://github.com/mylasertools/kerfscript/blob/main/LICENSE),
+or the free [commercial licence](https://github.com/mylasertools/kerfscript/blob/main/COMMERCIAL-LICENSE.md#free-commercial-licence)
+for closed-source use.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,133 @@
+# Third-party notices
+
+KerfScript bundles the following software in `dist/`. Their licences apply to
+those parts only.
+
+## Clipper2 / clipper2-ts 2.0.1-18 (bundled)
+
+Original Clipper2: Copyright Angus Johnson 2010–2025.
+TypeScript port by Jeremy Tribby (countertype).
+Source: https://github.com/countertype/clipper2-ts
+
+```text
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+```
+
+## opentype.js 1.3.4 (bundled)
+
+Source: https://github.com/opentypejs/opentype.js
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2020 Frederik De Bleser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## tiny-inflate 1.0.3 (bundled, part of opentype.js)
+
+Source: https://github.com/foliojs/tiny-inflate
+
+```text
+MIT License
+
+Copyright (c) 2015-present Devon Govett
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## string.prototype.codepointat 0.2.1 (bundled, part of opentype.js)
+
+Source: https://github.com/mathiasbynens/String.prototype.codePointAt
+
+```text
+Copyright Mathias Bynens <https://mathiasbynens.be/>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## Desktop app
+
+The desktop app is also built from Rust crates (Tauri and its dependencies)
+under MIT, Apache-2.0, MPL-2.0, BSD, ISC, Zlib, Unicode and similar licences.
+`desktop/THIRD-PARTY-LICENSES.md` lists each one with its licence text, and
+the installers place it next to the app.
+
+## Atkinson Hyperlegible (built into the command line and kerfscript.wasm)
+
+`fonts/AtkinsonHyperlegible-Regular.ttf`, Copyright 2020 Braille Institute
+of America, Inc., licensed under the SIL Open Font License 1.1. See
+`fonts/OFL.txt`. It is embedded unmodified in `dist/cli.js` and
+`kerfscript.wasm`, and the playground serves it; `dist/index.js` does not
+include it.

package/dist/budget.js

@@ -0,0 +1,9 @@
+import {
+  secondsToMidnight,
+  spend
+} from "./chunk-O5LBJLFO.js";
+import "./chunk-IY7POWTF.js";
+export {
+  secondsToMidnight,
+  spend
+};

package/dist/chunk-43YRASDL.js

@@ -0,0 +1,131 @@
+import {
+  secondsToMidnight
+} from "./chunk-O5LBJLFO.js";
+import {
+  createKerfScriptServer,
+  version
+} from "./chunk-JUDNQ5QA.js";
+import {
+  execute
+} from "./chunk-6NSCAH6P.js";
+
+// src/worker.ts
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { readRequestBody } from "@modelcontextprotocol/sdk/server/requestBody.js";
+var MAX_BODY = 256e3;
+var jsonRpcError = (status, code, message, headers) => {
+  headers.set("Content-Type", "application/json");
+  return new Response(JSON.stringify({ jsonrpc: "2.0", error: { code, message }, id: null }), {
+    status,
+    headers
+  });
+};
+function clientAddress(ip) {
+  if (!ip.includes(":")) return ip;
+  const ipv4 = ip.match(/:(\d+\.\d+\.\d+\.\d+)$/);
+  if (ipv4) return ipv4[1];
+  const [head = "", tail] = ip.toLowerCase().split("::");
+  const groups = (s = "") => s ? s.split(":") : [];
+  const front = groups(head);
+  const full = tail === void 0 ? front : [...front, ...Array(8 - front.length - groups(tail).length).fill("0"), ...groups(tail)];
+  return `${full.slice(0, 4).map((g) => parseInt(g, 16).toString(16)).join(":")}::/64`;
+}
+async function charge(env, pool, client) {
+  try {
+    return await env.DAILY_BUDGET.get(env.DAILY_BUDGET.idFromName(pool)).spend(pool, client);
+  } catch {
+    return "total";
+  }
+}
+async function handleRequest(request, env, caller) {
+  const url = new URL(request.url);
+  if (url.pathname === "/health") return Response.json({ name: "kerfscript-mcp", version });
+  if (url.pathname !== "/mcp") return new Response("Not found", { status: 404 });
+  const origin = request.headers.get("Origin");
+  const allowed = env.ALLOWED_ORIGINS.split(",").map((s) => s.trim());
+  if (origin && !allowed.includes(origin))
+    return new Response("Origin not allowed", { status: 403 });
+  const headers = new Headers({
+    "Cache-Control": "no-store",
+    "X-Content-Type-Options": "nosniff",
+    Vary: "Origin"
+  });
+  if (origin) headers.set("Access-Control-Allow-Origin", origin);
+  if (request.method === "OPTIONS") {
+    headers.set("Access-Control-Allow-Methods", "POST, OPTIONS");
+    headers.set(
+      "Access-Control-Allow-Headers",
+      "Content-Type, Accept, MCP-Protocol-Version, MCP-Session-Id"
+    );
+    return new Response(null, { status: 204, headers });
+  }
+  if (request.method !== "POST") {
+    headers.set("Allow", "POST, OPTIONS");
+    return new Response("This stateless endpoint accepts POST requests.", {
+      status: 405,
+      headers
+    });
+  }
+  const ip = request.headers.get("CF-Connecting-IP");
+  if (caller !== void 0 && (!caller.trim() || caller.length > 200))
+    return new Response("A stable caller identity is required.", { status: 400 });
+  if (caller === void 0 && !ip)
+    return new Response("Missing client IP. Service bindings must use fetchForCaller.", {
+      status: 400
+    });
+  const key = caller !== void 0 ? `caller:${caller}` : `ip:${clientAddress(ip)}`;
+  if (!(await env.REQUEST_LIMIT.limit({ key })).success) {
+    headers.set("Retry-After", "60");
+    return new Response("Rate limit exceeded. Retry in one minute.", { status: 429, headers });
+  }
+  const body = await readRequestBody(request, MAX_BODY);
+  if (body.tooLarge)
+    return jsonRpcError(413, -32e3, `Request body must not exceed ${MAX_BODY} bytes.`, headers);
+  let message;
+  try {
+    message = JSON.parse(body.text);
+  } catch {
+    return jsonRpcError(400, -32700, "Parse error: Invalid JSON", headers);
+  }
+  if (Array.isArray(message))
+    return jsonRpcError(
+      400,
+      -32600,
+      "Batches are not supported. Send one message per request.",
+      headers
+    );
+  const spent = await charge(env, caller !== void 0 ? "service" : "public", key);
+  if (spent !== "ok") {
+    headers.set("Retry-After", String(secondsToMidnight()));
+    return spent === "client" ? new Response("Daily limit for this client reached. Retry after midnight UTC.", {
+      status: 429,
+      headers
+    }) : new Response("The service has reached its daily limit. Retry after midnight UTC.", {
+      status: 503,
+      headers
+    });
+  }
+  const server = createKerfScriptServer(async (job) => execute(job));
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: void 0,
+    enableJsonResponse: true,
+    maxRequestBodySize: MAX_BODY
+  });
+  try {
+    await server.connect(transport);
+    const response = await transport.handleRequest(request, { parsedBody: message });
+    for (const [key2, value] of headers) response.headers.set(key2, value);
+    return response;
+  } finally {
+    await server.close();
+  }
+}
+var worker_default = {
+  fetch: (request, env) => handleRequest(request, env)
+};
+
+export {
+  clientAddress,
+  handleRequest,
+  worker_default
+};