ai-diagrams-mcp 1.0.2 → 1.1.0

package/README.md

@@ -8,6 +8,7 @@ An MCP (Model Context Protocol) server that renders Mermaid diagrams to an inter
 - **Multiple Diagrams** - Render multiple diagrams in a single view
 - **Mermaid Themes** - Support for default, dark, forest, and neutral themes
 - **Light/Dark Mode** - Automatic system preference detection with manual toggle
+- **Shareable Links** - Upload diagrams and get public HTTPS links (no account required)
 - **Cross-Platform** - Works on macOS, Linux, and Windows
 
 ## Quick Start
@@ -257,11 +258,13 @@ The `render_diagram` tool accepts:
 
 - **diagrams** - Array of `{ title?: string, code: string }` objects
 - **theme** - Optional: `'default'` | `'dark'` | `'forest'` | `'neutral'`
+- **share** - Optional: `true` to upload and get a public shareable link
+- **shareExpiry** - Optional: `'1h'` | `'12h'` | `'24h'` | `'72h'` (default: `'1h'`)
 
 ## Example
 
 ```javascript
-// Tool call
+// Tool call - local only
 {
   "diagrams": [
     {
@@ -271,6 +274,17 @@ The `render_diagram` tool accepts:
   ],
   "theme": "dark"
 }
+
+// Tool call - with shareable link
+{
+  "diagrams": [
+    {
+      "title": "Authentication Flow",
+      "code": "graph TD\n  A[User] -->|Login| B[Auth Server]\n  B -->|Token| A"
+    }
+  ],
+  "share": true
+}
 ```
 
 ## Supported Diagram Types
@@ -298,6 +312,31 @@ See [Mermaid documentation](https://mermaid.js.org/intro/) for full syntax refer
 - **Reset** - Return to original view
 - **Theme Toggle** - Switch between light, dark, and system modes
 
+## Sharing
+
+Generate temporary public links to share diagrams with colleagues:
+
+```javascript
+{
+  "diagrams": [...],
+  "share": true,
+  "shareExpiry": "24h"  // Options: 1h, 12h, 24h, 72h
+}
+```
+
+- No account required
+- Full interactive viewer with zoom/pan
+- Links expire automatically (default: 1h)
+
+## Output Files
+
+Each render creates two files in the temp directory:
+
+- `mermaid-viewer-{uuid}.html` - Interactive viewer (opened in browser)
+- `mermaid-source-{uuid}.json` - Diagram source for reference/iteration
+
+The source file makes it easy to adjust and re-render diagrams.
+
 ## Development
 
 ```bash

package/dist/sharing/index.d.ts

@@ -0,0 +1,16 @@
+export interface ShareResult {
+    url: string;
+    expiresIn: string;
+}
+/**
+ * Format expiry for display
+ */
+export declare function formatExpiry(expiresIn: string): string;
+/**
+ * Upload HTML to litterbox.catbox.moe (anonymous, temporary file hosting)
+ * No restrictive CSP - JavaScript execution works fully
+ *
+ * Retention options: 1h, 12h, 24h, 72h
+ */
+export declare function uploadToLitterbox(html: string, filename: string, time?: '1h' | '12h' | '24h' | '72h'): Promise<ShareResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/sharing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAa,GACzC,OAAO,CAAC,WAAW,CAAC,CAkBtB"}

package/dist/sharing/index.js

@@ -0,0 +1,28 @@
+/**
+ * Format expiry for display
+ */
+export function formatExpiry(expiresIn) {
+    return `in ${expiresIn}`;
+}
+/**
+ * Upload HTML to litterbox.catbox.moe (anonymous, temporary file hosting)
+ * No restrictive CSP - JavaScript execution works fully
+ *
+ * Retention options: 1h, 12h, 24h, 72h
+ */
+export async function uploadToLitterbox(html, filename, time = '72h') {
+    const formData = new FormData();
+    formData.append('reqtype', 'fileupload');
+    formData.append('time', time);
+    formData.append('fileToUpload', new Blob([html], { type: 'text/html' }), filename);
+    const response = await fetch('https://litterbox.catbox.moe/resources/internals/api.php', {
+        method: 'POST',
+        body: formData,
+    });
+    if (!response.ok) {
+        throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+    }
+    const url = await response.text();
+    return { url: url.trim(), expiresIn: time };
+}
+//# sourceMappingURL=index.js.map

package/dist/sharing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,MAAM,SAAS,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,QAAgB,EAChB,OAAqC,KAAK;IAE1C,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,0DAA0D,EAAE;QACvF,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAElC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/tools/render-diagram.d.ts

@@ -10,6 +10,13 @@ export declare const renderDiagramSchema: z.ZodObject<{
         forest: "forest";
         neutral: "neutral";
     }>>>;
+    share: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    shareExpiry: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        "1h": "1h";
+        "12h": "12h";
+        "24h": "24h";
+        "72h": "72h";
+    }>>>;
 }, z.core.$strip>;
 export type RenderDiagramInput = z.infer<typeof renderDiagramSchema>;
 export declare function renderDiagram(input: RenderDiagramInput): Promise<string>;

package/dist/tools/render-diagram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-diagram.d.ts","sourceRoot":"","sources":["../../src/tools/render-diagram.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAe9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB9E"}
+{"version":3,"file":"render-diagram.d.ts","sourceRoot":"","sources":["../../src/tools/render-diagram.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAyB9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmD9E"}

package/dist/tools/render-diagram.js

@@ -4,6 +4,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import open from 'open';
 import { z } from 'zod';
+import { uploadToLitterbox, formatExpiry } from '../sharing/index.js';
 import { generateViewerHTML } from '../templates/viewer-bundle.js';
 export const renderDiagramSchema = z.object({
     diagrams: z
@@ -18,6 +19,16 @@ export const renderDiagramSchema = z.object({
         .optional()
         .default('default')
         .describe('Mermaid theme to use'),
+    share: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Upload and return a public shareable link'),
+    shareExpiry: z
+        .enum(['1h', '12h', '24h', '72h'])
+        .optional()
+        .default('1h')
+        .describe('How long the shareable link should last (default: 1h)'),
 });
 export async function renderDiagram(input) {
     // Validate input
@@ -28,15 +39,39 @@ export async function renderDiagram(input) {
         theme: validated.theme,
     });
     // Create unique filename in temp directory
-    const filename = `mermaid-viewer-${randomUUID()}.html`;
+    const uuid = randomUUID();
+    const filename = `mermaid-viewer-${uuid}.html`;
     const filepath = join(tmpdir(), filename);
-    // Write HTML file
-    await writeFile(filepath, html, 'utf-8');
+    // Also save diagram source for easy reference/iteration
+    const sourceFilename = `mermaid-source-${uuid}.json`;
+    const sourceFilepath = join(tmpdir(), sourceFilename);
+    const sourceData = {
+        diagrams: validated.diagrams,
+        theme: validated.theme,
+        generatedAt: new Date().toISOString(),
+    };
+    // Write HTML file and source file
+    await Promise.all([
+        writeFile(filepath, html, 'utf-8'),
+        writeFile(sourceFilepath, JSON.stringify(sourceData, null, 2), 'utf-8'),
+    ]);
     // Open in default browser
     await open(filepath);
-    // Return success message
+    // Build result message
     const diagramCount = validated.diagrams.length;
     const diagramWord = diagramCount === 1 ? 'diagram' : 'diagrams';
-    return `Successfully rendered ${diagramCount} ${diagramWord} and opened in browser.\nFile saved to: ${filepath}`;
+    let result = `Successfully rendered ${diagramCount} ${diagramWord} and opened in browser.\nFile saved to: ${filepath}\nSource saved to: ${sourceFilepath}`;
+    // Upload to litterbox if sharing is enabled
+    if (validated.share) {
+        try {
+            const shareResult = await uploadToLitterbox(html, filename, validated.shareExpiry);
+            result += `\n\nShareable link: ${shareResult.url}\nExpires: ${formatExpiry(shareResult.expiresIn)}`;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            result += `\n\nFailed to create shareable link: ${message}`;
+        }
+    }
+    return result;
 }
 //# sourceMappingURL=render-diagram.js.map

package/dist/tools/render-diagram.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-diagram.js","sourceRoot":"","sources":["../../src/tools/render-diagram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,+BAA+B,CAAC;AAEtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC;SACR,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAClD,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;SAC9C,QAAQ,EAAE;SACV,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,sBAAsB,CAAC;CACpC,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,iBAAiB;IACjB,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnD,gBAAgB;IAChB,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,KAAK,EAAE,SAAS,CAAC,KAAqB;KACvC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,kBAAkB,UAAU,EAAE,OAAO,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE1C,kBAAkB;IAClB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAErB,yBAAyB;IACzB,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/C,MAAM,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAEhE,OAAO,yBAAyB,YAAY,IAAI,WAAW,2CAA2C,QAAQ,EAAE,CAAC;AACnH,CAAC"}
+{"version":3,"file":"render-diagram.js","sourceRoot":"","sources":["../../src/tools/render-diagram.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-diagrams-mcp",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "MCP server for rendering Mermaid diagrams with interactive zoom/pan viewer",
   "type": "module",
   "main": "./dist/index.js",