@drawpro/mcp 0.4.0 → 0.4.1

package/README.md

@@ -123,7 +123,21 @@ coordinates.
 
 ## Usage log
 
-Set `DRAWPRO_MCP_LOG` to record every tool call as JSONL:
+Turning telemetry on is enough to start recording:
+
+```bash
+npx -y @drawpro/mcp telemetry      # show the state and the exact payload
+npx -y @drawpro/mcp telemetry on   # records to ~/.drawpro/usage.jsonl and shares an aggregate
+npx -y @drawpro/mcp telemetry off
+npx -y @drawpro/mcp report         # send once, without turning anything on
+```
+
+Consenting to *send* usage implies consent to *record* it — recording is the
+lesser act — so opting in does not also require configuring a log. The
+implication does not run the other way: setting `DRAWPRO_MCP_LOG` records
+locally and shares nothing.
+
+To record without ever sharing, set the path yourself:
 
 ```bash
 claude mcp add drawpro --scope user \
@@ -131,9 +145,14 @@ claude mcp add drawpro --scope user \
   -e DRAWPRO_MCP_LOG="$HOME/.drawpro/usage.jsonl" \
   -- npx -y @drawpro/mcp
 
-drawpro-mcp stats                 # or: npx -y @drawpro/mcp stats
+npx -y @drawpro/mcp stats
 ```
 
+> Run these from anywhere except a checkout of this repository. Inside it, npm
+> resolves `@drawpro/mcp` to the workspace copy, whose bin is not linked, and
+> npx fails with `drawpro-mcp: command not found`. Use
+> `node packages/mcp/dist/server.js <command>` there instead.
+
 ```
 5 calls  2026-08-29 .. 2026-08-29
 

package/dist/server.js

@@ -25,6 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/server.ts
 var import_node_fs3 = require("node:fs");
+var import_node_os3 = require("node:os");
 var import_node_path3 = require("node:path");
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
@@ -1406,7 +1407,7 @@ function api() {
   return clientInstance;
 }
 var SESSION_ID = Math.random().toString(36).slice(2, 10);
-var VERSION = "0.4.0";
+var VERSION = "0.4.1";
 var inFlight = [];
 var cachedUser = null;
 async function currentUser() {
@@ -1432,10 +1433,17 @@ function text(body) {
 function sheetUrl(workspaceId, sheetId) {
   return `${APP_URL}/workspace/${workspaceId}/sheet/${sheetId}`;
 }
+var DEFAULT_LOG = (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".drawpro", "usage.jsonl");
+function logPath() {
+  const explicit = process.env.DRAWPRO_MCP_LOG;
+  if (explicit) return explicit;
+  return telemetryEnabled() ? DEFAULT_LOG : void 0;
+}
 function logCall(entry) {
-  const path = process.env.DRAWPRO_MCP_LOG;
+  const path = logPath();
   if (!path) return;
   try {
+    (0, import_node_fs3.mkdirSync)((0, import_node_path3.join)((0, import_node_os3.homedir)(), ".drawpro"), { recursive: true, mode: 448 });
     (0, import_node_fs3.appendFileSync)(path, JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry }) + "\n");
   } catch {
   }
@@ -1843,9 +1851,11 @@ function summariseLog(file) {
   };
 }
 function stats(path, asJson) {
-  const file = path ?? process.env.DRAWPRO_MCP_LOG;
+  const file = path ?? logPath();
   if (!file) {
-    console.error("Set DRAWPRO_MCP_LOG, or pass a path: drawpro-mcp stats <file>");
+    console.error(
+      "No usage is being recorded. Either set DRAWPRO_MCP_LOG, turn on telemetry\n(which records to ~/.drawpro/usage.jsonl), or pass a path: drawpro-mcp stats <file>"
+    );
     process.exit(2);
   }
   const summary = summariseLog(file);
@@ -1874,7 +1884,7 @@ function stats(path, asJson) {
   console.log("  Add --json for a machine-readable copy.");
 }
 function buildReport() {
-  const file = process.env.DRAWPRO_MCP_LOG;
+  const file = logPath();
   if (!file) return null;
   const summary = summariseLog(file);
   if (!summary) return null;
@@ -1907,8 +1917,11 @@ async function telemetry(action) {
   const report = buildReport();
   if (action === "on") {
     writeConfig({ telemetry: "on" });
-    console.log("Telemetry on. Roughly once a day, this is sent:\n");
-    console.log(report ? JSON.stringify(report, null, 2) : "  (nothing yet \u2014 set DRAWPRO_MCP_LOG to record usage)");
+    console.log(`Telemetry on. Usage is recorded to ${logPath()}`);
+    console.log("Roughly once a day, an aggregate of it is sent:\n");
+    console.log(
+      report ? JSON.stringify(report, null, 2) : "  (no calls recorded yet \u2014 the first report goes out once you have used the tools)"
+    );
     console.log("\nTurn it off any time with: drawpro-mcp telemetry off");
     return;
   }
@@ -1916,7 +1929,9 @@ async function telemetry(action) {
 `);
   console.log("If enabled, this is the entire payload \u2014 tool counts and timings,");
   console.log("no account, no token, no workspace or sheet ids, nothing drawn:\n");
-  console.log(report ? JSON.stringify(report, null, 2) : "  (nothing recorded yet \u2014 set DRAWPRO_MCP_LOG first)");
+  console.log(
+    report ? JSON.stringify(report, null, 2) : `  (no calls recorded yet; recording ${logPath() ? `to ${logPath()}` : "is off"})`
+  );
   console.log("\n  drawpro-mcp telemetry on     share it");
   console.log("  drawpro-mcp telemetry off    stop");
   console.log("  drawpro-mcp report           send once now, without turning it on");
@@ -1924,7 +1939,9 @@ async function telemetry(action) {
 async function reportOnce() {
   const report = buildReport();
   if (!report) {
-    console.error("Nothing to report. Set DRAWPRO_MCP_LOG to record usage first.");
+    console.error(
+      "Nothing to report \u2014 no usage has been recorded. Set DRAWPRO_MCP_LOG, or\nturn on telemetry, which records to ~/.drawpro/usage.jsonl."
+    );
     process.exit(2);
   }
   console.log("Sending:\n");

package/package.json

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