@sanjibdevnath/mcp-excalidraw-local 1.0.0

package/skills/excalidraw-skill/scripts/delete-element.cjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const DEFAULT_URL = process.env.EXPRESS_SERVER_URL || "http://localhost:3000";
+
+function usage() {
+  console.error("Usage: node scripts/delete-element.cjs --id <id> [--url <canvasUrl>]");
+  process.exit(2);
+}
+
+function parseArgs(argv) {
+  const out = { url: DEFAULT_URL, id: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url") out.url = argv[++i];
+    else if (a === "--id") out.id = argv[++i];
+  }
+  return out;
+}
+
+async function main() {
+  if (typeof fetch !== "function") {
+    throw new Error("This script requires Node 18+ (global fetch).");
+  }
+
+  const args = parseArgs(process.argv.slice(2));
+  if (!args.id) usage();
+
+  const baseUrl = args.url.replace(/\/$/, "");
+  const res = await fetch(`${baseUrl}/api/elements/${encodeURIComponent(args.id)}`, {
+    method: "DELETE",
+  });
+
+  const json = await res.json().catch(() => null);
+  if (!res.ok || !json || json.success !== true) {
+    throw new Error(
+      `Failed to delete element: ${res.status} ${res.statusText} ${json?.error ? `- ${json.error}` : ""}`,
+    );
+  }
+
+  console.log(`Deleted ${args.id}`);
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exit(1);
+});
+

package/skills/excalidraw-skill/scripts/export-elements.cjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const DEFAULT_URL = process.env.EXPRESS_SERVER_URL || "http://localhost:3000";
+
+function parseArgs(argv) {
+  const out = { url: DEFAULT_URL, outFile: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url") out.url = argv[++i];
+    else if (a === "--out") out.outFile = argv[++i];
+    else if (a === "-o") out.outFile = argv[++i];
+  }
+  return out;
+}
+
+async function main() {
+  if (typeof fetch !== "function") {
+    throw new Error("This script requires Node 18+ (global fetch).");
+  }
+
+  const { url, outFile } = parseArgs(process.argv.slice(2));
+  const res = await fetch(`${url.replace(/\/$/, "")}/api/elements`);
+  const json = await res.json();
+
+  if (!res.ok || !json || json.success !== true) {
+    throw new Error(`Failed to export elements: ${res.status} ${res.statusText}`);
+  }
+
+  const payload = {
+    exportedAt: new Date().toISOString(),
+    expressServerUrl: url,
+    elements: json.elements || [],
+  };
+
+  const text = JSON.stringify(payload, null, 2);
+  if (!outFile) {
+    process.stdout.write(text + "\n");
+    return;
+  }
+
+  fs.mkdirSync(path.dirname(outFile), { recursive: true });
+  fs.writeFileSync(outFile, text + "\n");
+  console.log(`Wrote ${payload.elements.length} elements to ${outFile}`);
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exit(1);
+});

package/skills/excalidraw-skill/scripts/healthcheck.cjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const DEFAULT_URL = process.env.EXPRESS_SERVER_URL || "http://localhost:3000";
+
+function parseArgs(argv) {
+  const out = { url: DEFAULT_URL };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url") out.url = argv[++i];
+  }
+  return out;
+}
+
+async function main() {
+  if (typeof fetch !== "function") {
+    throw new Error("This script requires Node 18+ (global fetch).");
+  }
+
+  const { url } = parseArgs(process.argv.slice(2));
+  const res = await fetch(`${url.replace(/\/$/, "")}/health`);
+  const text = await res.text();
+
+  if (!res.ok) {
+    console.error(text);
+    process.exit(1);
+  }
+
+  console.log(text);
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exit(1);
+});

package/skills/excalidraw-skill/scripts/import-elements.cjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const fs = require("node:fs");
+
+const DEFAULT_URL = process.env.EXPRESS_SERVER_URL || "http://localhost:3000";
+
+function usage() {
+  console.error(
+    [
+      "Usage:",
+      "  node scripts/import-elements.cjs --in <file> [--mode batch|sync] [--url <canvasUrl>]",
+      "",
+      "Modes:",
+      "  batch  POST /api/elements/batch    (append; creates elements)",
+      "  sync   POST /api/elements/sync     (overwrite; clears then writes)",
+    ].join("\n"),
+  );
+  process.exit(2);
+}
+
+function parseArgs(argv) {
+  const out = { url: DEFAULT_URL, inFile: null, mode: "batch" };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url") out.url = argv[++i];
+    else if (a === "--in") out.inFile = argv[++i];
+    else if (a === "--mode") out.mode = argv[++i];
+  }
+  return out;
+}
+
+function readElementsFromFile(inFile) {
+  const raw = fs.readFileSync(inFile, "utf8");
+  const data = JSON.parse(raw);
+  if (Array.isArray(data)) return data;
+  if (data && Array.isArray(data.elements)) return data.elements;
+  throw new Error('Input file must be an array, or an object with an "elements" array');
+}
+
+async function main() {
+  if (typeof fetch !== "function") {
+    throw new Error("This script requires Node 18+ (global fetch).");
+  }
+
+  const { url, inFile, mode } = parseArgs(process.argv.slice(2));
+  if (!inFile) usage();
+  if (mode !== "batch" && mode !== "sync") usage();
+
+  const elements = readElementsFromFile(inFile);
+  const baseUrl = url.replace(/\/$/, "");
+
+  let endpoint;
+  let body;
+  if (mode === "batch") {
+    endpoint = `${baseUrl}/api/elements/batch`;
+    body = { elements };
+  } else {
+    endpoint = `${baseUrl}/api/elements/sync`;
+    body = { elements, timestamp: new Date().toISOString() };
+  }
+
+  const res = await fetch(endpoint, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+
+  const json = await res.json().catch(() => null);
+  if (!res.ok || !json || json.success !== true) {
+    throw new Error(`Failed to import elements: ${res.status} ${res.statusText} ${json?.error ? `- ${json.error}` : ""}`);
+  }
+
+  const count = json.count ?? json.elements?.length ?? elements.length;
+  console.log(`Imported ${count} elements (${mode})`);
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exit(1);
+});

package/skills/excalidraw-skill/scripts/update-element.cjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const fs = require("node:fs");
+
+const DEFAULT_URL = process.env.EXPRESS_SERVER_URL || "http://localhost:3000";
+
+function usage() {
+  console.error(
+    [
+      "Usage:",
+      "  node scripts/update-element.cjs --id <id> (--data <json> | --file <path>) [--url <canvasUrl>]",
+      "",
+      "Examples:",
+      '  node scripts/update-element.cjs --id abc --data \'{"x":200,"y":250,"backgroundColor":"#ffeeee"}\'',
+      "  node scripts/update-element.cjs --id abc --file updates.json",
+    ].join("\n"),
+  );
+  process.exit(2);
+}
+
+function parseArgs(argv) {
+  const out = { url: DEFAULT_URL, id: null, data: null, file: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url") out.url = argv[++i];
+    else if (a === "--id") out.id = argv[++i];
+    else if (a === "--data") out.data = argv[++i];
+    else if (a === "--file") out.file = argv[++i];
+  }
+  return out;
+}
+
+function readJson({ data, file }) {
+  if (data) return JSON.parse(data);
+  if (file) return JSON.parse(fs.readFileSync(file, "utf8"));
+  usage();
+}
+
+async function main() {
+  if (typeof fetch !== "function") {
+    throw new Error("This script requires Node 18+ (global fetch).");
+  }
+
+  const args = parseArgs(process.argv.slice(2));
+  if (!args.id) usage();
+  const payload = readJson(args);
+
+  const baseUrl = args.url.replace(/\/$/, "");
+  const res = await fetch(`${baseUrl}/api/elements/${encodeURIComponent(args.id)}`, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+
+  const json = await res.json().catch(() => null);
+  if (!res.ok || !json || json.success !== true) {
+    throw new Error(
+      `Failed to update element: ${res.status} ${res.statusText} ${json?.error ? `- ${json.error}` : ""}`,
+    );
+  }
+
+  process.stdout.write(JSON.stringify(json.element, null, 2) + "\n");
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exit(1);
+});
+