@drawpro/mcp 0.2.1 → 0.3.0

package/README.md

@@ -76,6 +76,7 @@ passcode itself.
 | `create_diagram` | no | returns a link to the new sheet |
 | `update_diagram` | no | replaces the sheet wholesale — regenerates layout |
 | `edit_sheet_text` | yes | rewrites named text in place, preserving every other element |
+| `import_sheet` | no | writes a local .excalidraw file into a sheet, coordinates verbatim |
 
 ### Editing a sheet a person drew
 
@@ -97,8 +98,16 @@ and nothing else moves — reflowing neighbours would be the wholesale rewrite
 this tool exists to avoid. Any box it grows is named in the result, so overlap
 with a neighbour is easy to spot and one drag to fix.
 
-It cannot add elements. A correction that needs a new box or a new annotation
-line is still a manual edit.
+It cannot add elements or move anything. A correction that needs a new box, a
+repositioned column, or a re-anchored arrow is a geometry change, and no spec or
+text edit can express one.
+
+`import_sheet` covers that case. Point it at a local `.excalidraw` file and it
+writes the scene in verbatim — every coordinate exactly as in the file. Because
+the server runs on your machine it can simply read the file, so a geometry pass
+can be done with a real editor, or by a model editing the file directly, and
+then pushed without a clipboard round trip. The file's contents go into the
+encrypted blob, never into the model's context.
 
 `update_diagram` remains the right tool for sheets this package generated, where
 regenerating the layout is the point.

package/dist/server.js

@@ -24,6 +24,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/server.ts
+var import_node_fs2 = require("node:fs");
+var import_node_path2 = require("node:path");
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_zod = require("zod");
@@ -338,7 +340,7 @@ function forgetKey(email) {
 
 // ../client/src/prompt.ts
 function askHidden(question) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const input = process.stdin;
     process.stdout.write(question);
     if (!input.isTTY) {
@@ -347,7 +349,7 @@ function askHidden(question) {
       input.on("data", (chunk) => {
         buffered += chunk;
       });
-      input.on("end", () => resolve(buffered.split("\n")[0].trim()));
+      input.on("end", () => resolve2(buffered.split("\n")[0].trim()));
       return;
     }
     const wasRaw = input.isRaw;
@@ -363,7 +365,7 @@ function askHidden(question) {
       if (result === null) {
         process.exit(130);
       }
-      resolve(result);
+      resolve2(result);
     };
     const onData = (chunk) => {
       for (const ch of chunk) {
@@ -1638,6 +1640,45 @@ ${sheetUrl(workspace_id, sheet_id)}`
     );
   }
 );
+server.tool(
+  "import_sheet",
+  "Write a local .excalidraw file into a sheet, exactly as it is. Use this when geometry has to change \u2014 repositioning, resizing, re-anchoring arrows \u2014 which no spec can express and edit_sheet_text will not touch. Every coordinate in the file is preserved verbatim.",
+  {
+    workspace_id: import_zod.z.string(),
+    file_path: import_zod.z.string().describe("Path to a .excalidraw file on this machine"),
+    name: import_zod.z.string().describe("Sheet name"),
+    sheet_id: import_zod.z.string().optional().describe("Omit to create a new sheet; supply it to replace an existing one")
+  },
+  async ({ workspace_id, file_path, name, sheet_id }) => {
+    let parsed;
+    try {
+      parsed = JSON.parse((0, import_node_fs2.readFileSync)((0, import_node_path2.resolve)(file_path), "utf8"));
+    } catch (err) {
+      return text(`Could not read ${file_path}: ${err.message}`);
+    }
+    const elements = parsed.elements;
+    if (!Array.isArray(elements) || elements.length === 0) {
+      return text(`${file_path} has no "elements" array \u2014 is it an .excalidraw file?`);
+    }
+    const issues = validateScene(elements);
+    const noted = issues.length ? `
+
+${issues.length} thing(s) worth a look (imported anyway):
+` + issues.slice(0, 5).map((i) => `  ${i.level}: ${i.message}`).join("\n") : "";
+    const user = await currentUser();
+    const payload = {
+      name,
+      elements,
+      appState: parsed.appState ?? {}
+    };
+    const sheet = sheet_id ? await api().updateSheet(workspace_id, sheet_id, payload, user.publicKey) : await api().createSheet(workspace_id, payload, user.publicKey);
+    const id = sheet_id ?? sheet.id;
+    return text(
+      `${sheet_id ? "Replaced" : "Created"} "${name}" from ${file_path} \u2014 ${elements.length} elements, every coordinate as in the file.
+${sheetUrl(workspace_id, id)}${noted}`
+    );
+  }
+);
 async function main() {
   const command = process.argv[2];
   if (command === "login") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawpro/mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "MCP server for DrawPro \u2014 read and create end-to-end encrypted Excalidraw diagrams from Claude",
   "license": "MIT",
   "repository": {