@eraserlabs/eraser-mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
-# @eraserlabs/eraser-mcp
+# Eraser MCP Server
 
-MCP (Model Context Protocol) server for generating diagrams with [eraser.io](https://eraser.io/?r=0).
+Model Context Protocol (MCP) server for generating diagrams with [Eraser](https://eraser.io).
 
-## Installation
+## Quick Start
 
 ```bash
 npx @eraserlabs/eraser-mcp
@@ -48,19 +48,28 @@ Add to your Claude Desktop config:
 
 ## Environment Variables
 
-- `ERASER_API_TOKEN` (required) - Your Eraser API token
-- `ERASER_API_URL` (optional) - Custom API URL (defaults to `https://app.eraser.io/api/mcp`)
-- `ERASER_OUTPUT_DIR` (optional) - Local directory to save rendered diagrams (defaults to `.eraser/scratchpad`)
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ERASER_API_TOKEN` | Yes | Your Eraser API token |
+| `ERASER_API_URL` | No | Custom API URL (default: `https://app.eraser.io/api/mcp`) |
+| `ERASER_OUTPUT_DIR` | No | Directory to save rendered diagrams (default: `.eraser/scratchpad`) |
 
 ## Available Tools
 
-- `renderSequenceDiagram` - Render sequence diagrams
-- `renderEntityRelationshipDiagram` - Render ERD diagrams
-- `renderCloudArchitectureDiagram` - Render cloud architecture diagrams
-- `renderFlowchart` - Render flowcharts
-- `renderBpmnDiagram` - Render BPMN diagrams
-- `renderPrompt` - Generate diagrams from natural language using AI
-- `renderElements` - Render multiple diagram elements
+| Tool | Description |
+|------|-------------|
+| `renderSequenceDiagram` | Render sequence diagrams |
+| `renderEntityRelationshipDiagram` | Render ERD diagrams |
+| `renderCloudArchitectureDiagram` | Render cloud architecture diagrams |
+| `renderFlowchart` | Render flowcharts |
+| `renderBpmnDiagram` | Render BPMN diagrams |
+| `renderPrompt` | Generate diagrams from natural language using AI |
+| `renderElements` | Render multiple diagram elements |
+
+## Documentation
+
+- [Eraser API Documentation](https://docs.eraser.io)
+- [Get an API Token](https://docs.eraser.io/reference/api-token)
 
 ## License
 

package/dist/tools.d.ts

@@ -40,7 +40,7 @@ declare const diagramElementSchema: z.ZodObject<{
 }>;
 declare const renderPromptSchema: z.ZodObject<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -74,7 +74,7 @@ declare const renderPromptSchema: z.ZodObject<{
     }>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -108,7 +108,7 @@ declare const renderPromptSchema: z.ZodObject<{
     }>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -143,7 +143,7 @@ declare const renderPromptSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 declare const renderElementsSchema: z.ZodObject<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -183,7 +183,7 @@ declare const renderElementsSchema: z.ZodObject<{
     skipCache: z.ZodOptional<z.ZodBoolean>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -223,7 +223,7 @@ declare const renderElementsSchema: z.ZodObject<{
     skipCache: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     padding: z.ZodOptional<z.ZodNumber>;
-    scale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     background: z.ZodOptional<z.ZodBoolean>;
     theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
     format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
@@ -269,8 +269,10 @@ declare const singleDiagramSchema: z.ZodObject<{
     styleMode: z.ZodOptional<z.ZodEnum<["plain", "shadow", "watercolor"]>>;
     typeface: z.ZodOptional<z.ZodEnum<["rough", "clean", "mono"]>>;
     background: z.ZodOptional<z.ZodBoolean>;
+    imageQuality: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
 }, "strip", z.ZodTypeAny, {
     code: string;
+    imageQuality?: 3 | 1 | 2 | undefined;
     background?: boolean | undefined;
     theme?: "light" | "dark" | undefined;
     typeface?: "rough" | "clean" | "mono" | undefined;
@@ -278,6 +280,7 @@ declare const singleDiagramSchema: z.ZodObject<{
     styleMode?: "plain" | "shadow" | "watercolor" | undefined;
 }, {
     code: string;
+    imageQuality?: 3 | 1 | 2 | undefined;
     background?: boolean | undefined;
     theme?: "light" | "dark" | undefined;
     typeface?: "rough" | "clean" | "mono" | undefined;

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCAAyC,CAAC;AACxE,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAC5E,eAAO,MAAM,gBAAgB,qCAAsC,CAAC;AACpE,eAAO,MAAM,iBAAiB,0CAA2C,CAAC;AAE1E;;;GAGG;AACH,oBAAY,YAAY;IACtB,EAAE,qBAAqB;IACvB,GAAG,gCAAgC;IACnC,GAAG,+BAA+B;IAClC,IAAI,sBAAsB;IAC1B,IAAI,iBAAiB;CACtB;AAED,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAMxB,CAAC;AAqBH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAwBR,CAAC;AAEjB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCASV,CAAC;AAGjB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAAI;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AA+RF,eAAO,MAAM,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CA6C9D,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAEhE;AAED,eAAO,MAAM,UAAU,yCAAqD,CAAC;AAG7E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAM3D,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,OAAO,kBAAkB,CAEzF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCAAyC,CAAC;AACxE,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAC5E,eAAO,MAAM,gBAAgB,qCAAsC,CAAC;AACpE,eAAO,MAAM,iBAAiB,0CAA2C,CAAC;AAE1E;;;GAGG;AACH,oBAAY,YAAY;IACtB,EAAE,qBAAqB;IACvB,GAAG,gCAAgC;IACnC,GAAG,+BAA+B;IAClC,IAAI,sBAAsB;IAC1B,IAAI,iBAAiB;CACtB;AAED,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAMxB,CAAC;AAqBH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAwBR,CAAC;AAEjB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCASV,CAAC;AAGjB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAAI;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAkRF,eAAO,MAAM,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CA6C9D,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAEhE;AAED,eAAO,MAAM,UAAU,yCAAqD,CAAC;AAG7E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAM3D,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,OAAO,kBAAkB,CAEzF"}

package/dist/tools.js

@@ -32,7 +32,7 @@ const diagramElementSchema = zod_1.z.object({
 const renderOptionsSchema = zod_1.z
     .object({
     padding: zod_1.z.number().optional(),
-    scale: zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(2), zod_1.z.literal(3)]).optional(),
+    imageQuality: zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(2), zod_1.z.literal(3)]).optional(),
     background: zod_1.z.boolean().optional(),
     theme: zod_1.z.enum(['light', 'dark']).optional(),
     format: zod_1.z.enum(['png', 'jpeg']).optional(),
@@ -90,6 +90,7 @@ const singleDiagramSchema = zod_1.z.object({
     styleMode: zod_1.z.enum(exports.styleModeSettings).optional(),
     typeface: zod_1.z.enum(exports.typefaceSettings).optional(),
     background: zod_1.z.boolean().optional(),
+    imageQuality: zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(2), zod_1.z.literal(3)]).optional(),
 });
 const renderPromptJsonSchema = {
     type: 'object',
@@ -121,7 +122,7 @@ const renderPromptJsonSchema = {
             },
         },
         padding: { type: 'number' },
-        scale: { type: 'number', enum: [1, 2, 3] },
+        imageQuality: { type: 'number', enum: [1, 2, 3] },
         background: { type: 'boolean' },
         theme: { type: 'string', enum: ['light', 'dark'] },
         format: { type: 'string', enum: ['png', 'jpeg'] },
@@ -158,7 +159,7 @@ const renderElementsJsonSchema = {
         returnElements: { type: 'boolean' },
         skipCache: { type: 'boolean' },
         padding: { type: 'number' },
-        scale: { type: 'number', enum: [1, 2, 3] },
+        imageQuality: { type: 'number', enum: [1, 2, 3] },
         background: { type: 'boolean' },
         theme: { type: 'string', enum: ['light', 'dark'] },
         format: { type: 'string', enum: ['png', 'jpeg'] },
@@ -178,6 +179,7 @@ const singleDiagramJsonSchema = {
         styleMode: { type: 'string', enum: [...exports.styleModeSettings] },
         typeface: { type: 'string', enum: [...exports.typefaceSettings] },
         background: { type: 'boolean', description: 'Whether to include a solid background' },
+        imageQuality: { type: 'number', enum: [1, 2, 3] },
     },
 };
 // Diagram type descriptions with syntax examples
@@ -186,38 +188,23 @@ const SEQUENCE_DIAGRAM_DESCRIPTION = `Render a sequence diagram. Use Eraser's se
 Example syntax:
 \`\`\`
 title Authentication Flow
+autoNumber on
 
-// Define actors with icons
-User [icon: user]
-Browser [icon: globe]
-Server [icon: server]
-Database [icon: database]
+Client [icon: monitor, color: gray]
+Server [icon: server, color: blue]
+Service [icon: tool, color: green]
 
-// Messages between actors
-User > Browser: Enter credentials
-Browser > Server: POST /login
-Server > Database: Query user
-Database > Server: User data
-Server > Browser: JWT token
-Browser > User: Login success
+Client > Server: Data request
+activate Server
+Server <> Service: Service request
 
-// Control flow
-alt [label: "Valid credentials"] {
-  Server > Browser: 200 OK
-}
-else [label: "Invalid"] {
-  Server > Browser: 401 Unauthorized
+loop [label: until success, color: green] {
+  Service > Service: Check availability
 }
 
-// Activation bars
-activate Server
-Server > Database: Query
+Server - Service: Data processing
+Server --> Client: Data response
 deactivate Server
-
-// Loops
-loop [label: "Retry 3 times"] {
-  Browser > Server: Request
-}
 \`\`\``;
 const ERD_DESCRIPTION = `Render an entity-relationship diagram. Use Eraser's ERD syntax.
 
@@ -296,11 +283,12 @@ API Service > RDS
 API Service > ElastiCache
 Worker Service > S3
 \`\`\``;
-const FLOWCHART_DESCRIPTION = `Render a flowchart diagram. Use Eraser's flowchart syntax.
+const FLOWCHART_DESCRIPTION = `Render a flowchart diagram. Use Eraser's flowchart syntax. Prefer horizontal layout (direction right) unless the user wants a vertical diagram.
 
 Example syntax:
 \`\`\`
 title User Registration Flow
+direction right
 
 // Nodes with shapes and icons
 Start [shape: oval, icon: play]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eraserlabs/eraser-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for generating diagrams with Eraser.io",
   "private": false,
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/eraserlabs/eraserio.git",
+    "url": "https://github.com/eraserlabs/eraser-io.git",
     "directory": "packages/eraser-mcp"
   },
   "license": "MIT",