@efectoapp/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,244 @@
+# Efecto MCP Server
+
+Model Context Protocol (MCP) server for programmatic poster creation with [Efecto](https://efecto.app).
+
+Create stunning visual designs with ASCII effects, glitch art, halftone patterns, and more—all from your CLI or AI agent.
+
+## Quick Start
+
+### Installation
+
+```bash
+# Clone and build
+git clone https://github.com/your-repo/efecto.git
+cd efecto/mcp-server
+pnpm install
+pnpm build
+```
+
+### Configure for Claude Code
+
+Add to your Claude Code settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "efecto": {
+      "command": "node",
+      "args": ["/absolute/path/to/efecto/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+Then restart Claude Code. You can verify it's working by asking Claude to list efecto tools.
+
+## Example Workflow
+
+> "Make a cyberpunk image that says DOPE for Instagram"
+
+```
+1. search_images({ query: "cyberpunk", orientation: "vertical" })
+   → Returns images from Lummi
+
+2. create_poster({ aspectRatio: "9:16" })
+   → Creates Instagram story format
+
+3. set_background({ type: "image", imageUrl: "<url from step 1>" })
+   → Sets the cyberpunk image as background
+
+4. apply_effect({ effectId: "glitch-digital" })
+   → Applies digital glitch effect
+
+5. add_postprocess({ type: "chromatic-aberration", strength: 0.02 })
+   → Adds RGB split effect
+
+6. add_postprocess({ type: "scanlines", intensity: 0.3 })
+   → Adds CRT scanlines
+
+7. add_layer({ type: "text", content: "DOPE", fontSize: 120, fontFamily: "Space Grotesk", color: "#ffffff" })
+   → Adds the title text
+
+8. generate_url()
+   → Returns shareable URL like https://efecto.app/canvas?lm=1&...
+```
+
+## Available Tools
+
+### Discovery Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_effects` | List all available main effects |
+| `list_fonts` | List available fonts for text layers |
+| `list_palettes` | List color palettes |
+| `list_materials` | List 3D materials |
+
+### Image Tools
+
+#### `search_images`
+
+Search for free stock images from Lummi.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `query` | string | Search query (e.g., "cyberpunk", "nature"). Empty = featured |
+| `orientation` | string | `"vertical"` (9:16), `"horizontal"` (16:9), `"square"` (1:1) |
+| `type` | string | `"photo"`, `"illustration"`, `"3d"` |
+| `luminance` | string | `"dark"`, `"neutral"`, `"bright"` |
+| `limit` | number | Max results (default: 10, max: 50) |
+
+### State Building Tools
+
+#### `create_poster`
+
+Create a new poster.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `aspectRatio` | string | `"16:9"` | `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"full"` |
+| `backgroundColor` | string | `"#1a1a1a"` | Background color (hex) |
+
+#### `set_background`
+
+Set the background layer (always at index 0).
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `type` | string | `"solid"` or `"image"` |
+| `color` | string | Hex color (for solid type) |
+| `imageUrl` | string | Image URL (for image type) |
+
+#### `add_layer`
+
+Add a layer to the poster.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `type` | string | `"text"`, `"image"`, `"video"`, `"3d"` |
+| `name` | string | Layer name |
+
+**Text layer parameters:**
+- `content`: Text content
+- `fontFamily`: Font name (e.g., "Space Grotesk", "Inter")
+- `fontSize`: Size in pixels
+- `fontWeight`: `"normal"`, `"medium"`, `"semibold"`, `"bold"`
+- `color`: Hex color
+- `textAlign`: `"left"`, `"center"`, `"right"`
+
+**Image/Video layer parameters:**
+- `mediaUrl`: Media URL
+- `objectFit`: `"cover"`, `"contain"`
+
+**Transform parameters (all layers):**
+- `x`, `y`: Position (-1 to 1, 0 = center)
+- `width`, `height`: Size (0 to 1+, 1 = full canvas)
+- `rotation`: Degrees
+- `opacity`: 0-1
+
+#### `modify_layer`
+
+Modify an existing layer by ID.
+
+#### `remove_layer`
+
+Remove a layer by ID (cannot remove background).
+
+#### `apply_effect`
+
+Apply the main effect. Only one can be active.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `effectId` | string | Effect ID (see below) |
+| `enabled` | boolean | Enable/disable (default: true) |
+
+**Available Effect IDs:**
+
+| Category | Effect IDs |
+|----------|------------|
+| ASCII | `ascii-standard`, `ascii-blocks`, `ascii-braille`, `ascii-hatching`, `ascii-matrix`, `ascii-technical`, `ascii-dense`, `ascii-minimal` |
+| Dither | `dither-floyd-steinberg`, `dither-atkinson`, `dither-jarvis-judice-ninke`, `dither-stucki`, `dither-burkes`, `dither-sierra`, `dither-two-row-sierra`, `dither-sierra-lite` |
+| Halftone | `halftone-mono`, `halftone-cmyk` |
+| Glitch | `glitch-chromatic`, `glitch-digital`, `glitch-vhs`, `glitch-weird` |
+| Art | `art-kuwahara`, `art-crosshatch`, `art-lineart`, `art-engraving`, `art-stipple` |
+| Special | `special-warp` |
+
+**Effect-specific parameters:**
+- ASCII: `cellSize` (4-32), `color` (bool), `invert` (bool)
+- Dither: `pixelation` (1-10), `colors` (array)
+- Halftone: `dotSize`
+- Glitch: `speed`
+
+#### `add_postprocess`
+
+Add a stackable post-processing effect.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `type` | string | Post-process type (see below) |
+| `enabled` | boolean | Enable/disable |
+
+**Post-process types:** `scanlines`, `vignette`, `chromatic-aberration`, `curvature`, `grain`, `noise`, `pixelate`, `wave`, `rgb-glitch`, `brightness-contrast`, `color-tint`, `palette`, `jitter`, `bloom`, `dot-screen`, `sepia`, `grid`, `light-beams`, `warp`, `motion-blur`
+
+**Common parameters by type:**
+- `scanlines`: `intensity`, `count`
+- `vignette`: `intensity`, `radius`
+- `chromatic-aberration`: `strength`, `angle`
+- `grain`: `intensity`, `size`, `speed`
+- `brightness-contrast`: `brightness`, `contrast`, `saturation`, `hue`
+- `palette`: `colors` (array), `intensity`
+
+#### `get_state`
+
+Get the current poster state as JSON.
+
+### Output Tools
+
+#### `generate_url`
+
+Generate a shareable URL for the current poster.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `baseUrl` | string | `"https://efecto.app"` | Base URL |
+
+Returns a URL that opens in any browser with all effects applied.
+
+#### `render_image`
+
+Render the poster to an image (async).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `format` | string | `"png"` | `"png"`, `"jpeg"`, `"webp"` |
+| `width` | number | auto | Output width |
+| `height` | number | auto | Output height |
+| `quality` | number | 90 | JPEG/WebP quality |
+
+Returns a job ID for polling status.
+
+## Development
+
+```bash
+pnpm install    # Install dependencies
+pnpm build      # Build TypeScript
+pnpm dev        # Watch mode
+pnpm start      # Run server
+```
+
+## API Endpoints
+
+The MCP server calls these Efecto API endpoints:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/v1/images/search` | GET | Search Lummi images |
+| `/api/v1/state/encode` | POST | Encode state to URL |
+| `/api/v1/state/decode` | POST | Decode URL to state |
+| `/api/v1/state/validate` | POST | Validate state |
+| `/api/v1/render` | POST | Render to image |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Efecto MCP Server
+ *
+ * Provides tools for programmatic poster creation via the Model Context Protocol.
+ *
+ * Tools:
+ * - list_effects: List available effects
+ * - list_fonts: List available fonts
+ * - list_palettes: List color palettes
+ * - list_materials: List 3D materials
+ * - search_images: Search for free stock images
+ * - create_poster: Create a new poster
+ * - set_background: Configure background layer
+ * - add_layer: Add a layer to the poster
+ * - modify_layer: Modify an existing layer
+ * - apply_effect: Apply main effect (ASCII, dither, etc.)
+ * - add_postprocess: Add post-processing effect
+ * - generate_url: Generate shareable URL
+ * - render_image: Render poster to image
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Efecto MCP Server
+ *
+ * Provides tools for programmatic poster creation via the Model Context Protocol.
+ *
+ * Tools:
+ * - list_effects: List available effects
+ * - list_fonts: List available fonts
+ * - list_palettes: List color palettes
+ * - list_materials: List 3D materials
+ * - search_images: Search for free stock images
+ * - create_poster: Create a new poster
+ * - set_background: Configure background layer
+ * - add_layer: Add a layer to the poster
+ * - modify_layer: Modify an existing layer
+ * - apply_effect: Apply main effect (ASCII, dither, etc.)
+ * - add_postprocess: Add post-processing effect
+ * - generate_url: Generate shareable URL
+ * - render_image: Render poster to image
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const discovery_js_1 = require("./tools/discovery.js");
+const state_js_1 = require("./tools/state.js");
+const output_js_1 = require("./tools/output.js");
+const images_js_1 = require("./tools/images.js");
+// Combine all tools
+const allTools = [...discovery_js_1.discoveryTools, ...images_js_1.imageTools, ...state_js_1.stateTools, ...output_js_1.outputTools];
+// Create server instance
+const server = new index_js_1.Server({
+    name: 'efecto-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool listing
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools: allTools };
+});
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // Discovery tools
+        if (discovery_js_1.discoveryTools.some(t => t.name === name)) {
+            return await (0, discovery_js_1.handleDiscoveryTool)(name, args);
+        }
+        // Image tools
+        if (images_js_1.imageTools.some(t => t.name === name)) {
+            return await (0, images_js_1.handleImageTool)(name, args);
+        }
+        // State tools
+        if (state_js_1.stateTools.some(t => t.name === name)) {
+            return await (0, state_js_1.handleStateTool)(name, args);
+        }
+        // Output tools
+        if (output_js_1.outputTools.some(t => t.name === name)) {
+            return await (0, output_js_1.handleOutputTool)(name, args);
+        }
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            isError: true,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Efecto MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/discovery.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Discovery Tools
+ *
+ * Read-only tools for listing available options:
+ * - list_effects: List all available post-processing effects
+ * - list_fonts: List all available fonts
+ * - list_palettes: List all color palettes
+ * - list_materials: List all 3D materials
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const discoveryTools: Tool[];
+/**
+ * Handle discovery tool calls
+ */
+export declare function handleDiscoveryTool(name: string, _args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/tools/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAG9D,eAAO,MAAM,cAAc,EAAE,IAAI,EAqChC,CAAA;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwG7D"}

package/dist/tools/discovery.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Discovery Tools
+ *
+ * Read-only tools for listing available options:
+ * - list_effects: List all available post-processing effects
+ * - list_fonts: List all available fonts
+ * - list_palettes: List all color palettes
+ * - list_materials: List all 3D materials
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoveryTools = void 0;
+exports.handleDiscoveryTool = handleDiscoveryTool;
+// Tool definitions for discovery
+exports.discoveryTools = [
+    {
+        name: 'list_effects',
+        description: 'List all available post-processing effects that can be applied to posters',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'list_fonts',
+        description: 'List all available fonts for text layers',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'list_palettes',
+        description: 'List all available color palettes',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'list_materials',
+        description: 'List all available 3D materials for 3D layers',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+];
+/**
+ * Handle discovery tool calls
+ */
+async function handleDiscoveryTool(name, _args) {
+    switch (name) {
+        case 'list_effects':
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            effects: [
+                                { id: 'ascii', name: 'ASCII', description: 'Convert to ASCII art characters' },
+                                { id: 'dither', name: 'Dither', description: 'Apply dithering patterns' },
+                                { id: 'halftone', name: 'Halftone', description: 'Apply halftone dot patterns' },
+                                { id: 'pixelate', name: 'Pixelate', description: 'Pixelate the image' },
+                                { id: 'noise', name: 'Noise', description: 'Add noise effects' },
+                                { id: 'glitch', name: 'Glitch', description: 'Apply glitch effects' },
+                                { id: 'rgbShift', name: 'RGB Shift', description: 'Shift RGB color channels' },
+                                { id: 'scanlines', name: 'Scanlines', description: 'Add CRT scanlines' },
+                                { id: 'vignette', name: 'Vignette', description: 'Add vignette effect' },
+                                { id: 'bloom', name: 'Bloom', description: 'Add glow/bloom effect' },
+                            ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        case 'list_fonts':
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            fonts: [
+                                { id: 'inter', name: 'Inter', category: 'sans-serif' },
+                                { id: 'roboto', name: 'Roboto', category: 'sans-serif' },
+                                { id: 'roboto-mono', name: 'Roboto Mono', category: 'monospace' },
+                                { id: 'playfair', name: 'Playfair Display', category: 'serif' },
+                                { id: 'space-grotesk', name: 'Space Grotesk', category: 'sans-serif' },
+                                { id: 'geist', name: 'Geist', category: 'sans-serif' },
+                                { id: 'geist-mono', name: 'Geist Mono', category: 'monospace' },
+                            ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        case 'list_palettes':
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            palettes: [
+                                { id: 'monochrome', name: 'Monochrome', colors: ['#000000', '#FFFFFF'] },
+                                { id: 'warm', name: 'Warm', colors: ['#FF6B6B', '#FFA500', '#FFD93D'] },
+                                { id: 'cool', name: 'Cool', colors: ['#4ECDC4', '#45B7D1', '#96CEB4'] },
+                                { id: 'neon', name: 'Neon', colors: ['#FF00FF', '#00FFFF', '#FFFF00'] },
+                                { id: 'pastel', name: 'Pastel', colors: ['#FFB5E8', '#B5DEFF', '#E7FFAC'] },
+                                { id: 'vintage', name: 'Vintage', colors: ['#8B4513', '#DAA520', '#CD853F'] },
+                            ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        case 'list_materials':
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            materials: [
+                                { id: 'standard', name: 'Standard', description: 'Basic material with color' },
+                                { id: 'metallic', name: 'Metallic', description: 'Metallic reflective surface' },
+                                { id: 'glass', name: 'Glass', description: 'Transparent glass material' },
+                                { id: 'plastic', name: 'Plastic', description: 'Shiny plastic surface' },
+                                { id: 'matte', name: 'Matte', description: 'Non-reflective matte surface' },
+                                { id: 'holographic', name: 'Holographic', description: 'Rainbow holographic effect' },
+                            ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        default:
+            return {
+                content: [{ type: 'text', text: `Unknown discovery tool: ${name}` }],
+            };
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/tools/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"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"}

package/dist/tools/images.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Image Tools
+ *
+ * Tools for searching and discovering images:
+ * - search_images: Search for free stock images from Lummi
+ *
+ * These tools call the Efecto REST API endpoints.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const imageTools: Tool[];
+/**
+ * Handle image tool calls
+ */
+export declare function handleImageTool(name: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=images.d.ts.map

package/dist/tools/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/tools/images.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAM9D,eAAO,MAAM,UAAU,EAAE,IAAI,EAsC5B,CAAA;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqH7D"}