ayphic-mcp-server 1.1.0

package/index.js

@@ -0,0 +1,838 @@
+#!/usr/bin/env node
+/**
+ * Ayphic Model Context Protocol (MCP) Server
+ * 
+ * Enables Claude Desktop, Cursor, and other MCP clients to directly control
+ * and edit the active Ayphic AI Video Editor multi-track timeline in real-time.
+ * 
+ * Standard: JSON-RPC 2.0 over stdio
+ */
+
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const DOCS_PATH = path.resolve(__dirname, '../server/agent/docs/EDITOR_CAPABILITIES.md');
+const API_BASE_URL = process.env.AYPHIC_API_URL || 'http://localhost:5000';
+const SERVER_NAME = 'ayphic-mcp-server';
+const SERVER_VERSION = '1.1.0';
+
+// Supported MCP Tools Definition
+const MCP_TOOLS = [
+  {
+    name: 'get_timeline',
+    description: 'Retrieve the active Ayphic video editor timeline state, canvas dimensions (width, height, FPS), active tracks (V1, V2, A1, C1), and all media items.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Optional project ID to retrieve. If omitted, retrieves the currently active open project.'
+        }
+      }
+    }
+  },
+  {
+    name: 'split_item',
+    description: 'Split one or more timeline items (video clips, audio, overlays) at specific frame numbers or timestamps (seconds). If id is omitted, automatically splits the primary video clip on track V1.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: ['string', 'array'],
+          description: 'ID or array of IDs of the timeline items to split. If omitted, targets the main video on track V1.'
+        },
+        newFrameNumber: {
+          type: ['number', 'array'],
+          description: 'Frame number(s) at which to split the items (e.g. 90 for 3 seconds at 30 FPS).'
+        },
+        timestamps: {
+          type: ['number', 'array'],
+          description: 'Timestamp(s) in seconds at which to split the items (e.g. 2.0 or [2, 5.5]).'
+        }
+      }
+    }
+  },
+  {
+    name: 'trim_item',
+    description: 'Trim a timeline item from the start or end to a specific target frame or timestamp. If id is omitted, targets the primary clip on track V1.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: 'string',
+          description: 'ID of the timeline item to trim. If omitted, targets the main video on track V1.'
+        },
+        from: {
+          type: 'string',
+          enum: ['start', 'end'],
+          description: 'Whether to trim from the "start" or "end".'
+        },
+        targetFrame: {
+          type: 'number',
+          description: 'Target frame number on the timeline.'
+        },
+        timestamps: {
+          type: 'number',
+          description: 'Target timestamp in seconds on the timeline.'
+        }
+      },
+      required: ['from']
+    }
+  },
+  {
+    name: 'delete_item',
+    description: 'Permanently delete one or more items (clips, text, shapes, sounds) or an entire track from the timeline.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: ['string', 'array'],
+          description: 'ID or array of IDs of items or tracks to delete (e.g. "item_123" or ["item_1", "item_2"]).'
+        }
+      },
+      required: ['id']
+    }
+  },
+  {
+    name: 'move_item',
+    description: 'Move or shift a timeline item to a new start frame or move it to a different track layer.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: ['string', 'array'],
+          description: 'ID or array of IDs of items to move.'
+        },
+        startFrame: {
+          type: 'number',
+          description: 'New start frame position on the timeline.'
+        },
+        layer: {
+          type: ['string', 'number'],
+          description: 'Target track layer ID (e.g. "V1", "V2", "A1").'
+        }
+      },
+      required: ['id', 'startFrame']
+    }
+  },
+  {
+    name: 'add_item',
+    description: 'Add a new element (video clip, image overlay, sound effect, background music, text, shape, or motion graphic) to the timeline. MANDATORY FOR IMAGES: NEVER hallucinate or guess 3rd-party image URLs (e.g. from pngmart, toppng, etc. which fail CORS/hotlinking). ALWAYS call `stock_search` ({ query: "indian flag", mediaType: "image" }) FIRST to obtain verified, high-speed CDN image URLs, and pass the returned `src` into `url`.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        type: {
+          type: 'string',
+          enum: ['video', 'image', 'sound', 'overlay', 'text', 'shape', 'motion', 'caption'],
+          description: 'Type of timeline element to add.'
+        },
+        url: {
+          type: 'string',
+          description: 'Direct URL or path of media asset (required for video, image, sound). Use `src` from stock_search for images/videos.'
+        },
+        layer: {
+          type: ['string', 'number'],
+          description: 'Target track layer (e.g. "V1" for main video, "V2" for overlays/text, "A1" for audio).'
+        },
+        startTime: {
+          type: 'number',
+          description: 'Start position in seconds.'
+        },
+        startFrame: {
+          type: 'number',
+          description: 'Start position in frames.'
+        },
+        duration: {
+          type: 'number',
+          description: 'Duration in seconds.'
+        },
+        backgroundRemoval: {
+          type: 'object',
+          properties: {
+            enabled: { type: 'boolean' }
+          },
+          description: 'Set { enabled: true } to remove background automatically for image overlays.'
+        },
+        extra: {
+          type: 'object',
+          description: 'Additional properties such as text content, shapeType, styles, etc.'
+        }
+      },
+      required: ['type']
+    }
+  },
+  {
+    name: 'update_property',
+    description: 'Update properties (styles, colors, fonts, animations, opacity, coordinates) of an existing timeline element. CRITICAL: Never guess or invent non-existent properties, animation types, or easing names (e.g. do not invent "slideInUpScale" or "easeOutElastic"). Always check exact names with search_docs first. Supported entrance animations (.in): "fadeIn", "slideUp", "slideDown", "slideLeft", "slideRight", "scaleIn", "popIn", "bounceIn", "rotateIn", "rotate3DIn", "blurIn", "glitchIn", "neonPulse", "revealIn", "slideBlur", "wavyIn", "bubblePopText", "animatedText", "pulsingText", "typewriterSubtitle", "wordSlideBlur", "wordSaasLaunch". Supported loop animations (.loop): "bounce", "float", "pulse", "shake", "spin", "breathe", "glow", "rainbow", "wiggle". Supported exit animations (.out): "fadeOut", "scaleOut", "blurOut", "bounceOut", "slideUp", "slideDown", "slideLeft", "slideRight", "popOut", "rotateOut".',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: ['string', 'array'],
+          description: 'ID or array of IDs of elements to update.'
+        },
+        property: {
+          type: 'string',
+          description: 'Dot-notation path of property to modify (e.g. "style.opacity", "animation.in", "style.fontSize", "style.color", "style.filter").'
+        },
+        value: {
+          description: 'New value for the property.'
+        }
+      },
+      required: ['id', 'property', 'value']
+    }
+  },
+  {
+    name: 'set_position',
+    description: 'Position an element on the canvas using standard layout keywords (center, top, bottom, left, right, top-left, top-right, bottom-left, bottom-right).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        target: {
+          type: 'string',
+          description: 'ID of the element to position.'
+        },
+        position: {
+          type: 'string',
+          enum: ['center', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right'],
+          description: 'Target position keyword on the canvas.'
+        },
+        anchor: {
+          type: 'string',
+          description: 'Optional anchor element ID. If omitted, positions relative to the entire canvas.'
+        }
+      },
+      required: ['target', 'position']
+    }
+  },
+  {
+    name: 'adjust_color',
+    description: 'Apply visual color adjustments, filters (grayscale, sepia, invert, fresco), brightness, contrast, and saturation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: 'string',
+          description: 'ID of the element to adjust.'
+        },
+        adjustments: {
+          type: 'object',
+          properties: {
+            brightness: { type: 'number' },
+            contrast: { type: 'number' },
+            saturation: { type: 'number' },
+            blur: { type: 'number' },
+            opacity: { type: 'number' },
+            filter: {
+              type: ['string', 'object'],
+              description: 'Visual filter preset name or object (e.g. "grayscale" or { type: "grayscale", intensity: 100 }).'
+            }
+          }
+        }
+      },
+      required: ['id']
+    }
+  },
+  {
+    name: 'stock_search',
+    description: 'REQUIRED FIRST STEP FOR STOCK IMAGES & B-ROLL: Search Pexels for royalty-free stock photos or video clips by keyword. Always call this tool to find valid high-resolution image/video assets (e.g. `pexels://photo/12345` or `pexels://video/67890`) before calling `add_item`.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'Search keyword (e.g. "indian flag", "modern technology", "neon city", "coffee morning").'
+        },
+        mediaType: {
+          type: 'string',
+          enum: ['video', 'image'],
+          description: 'Filter by "video" or "image" (default: "video").'
+        },
+        count: {
+          type: 'number',
+          description: 'Number of results to return (default: 5).'
+        }
+      },
+      required: ['query']
+    }
+  },
+  {
+    name: 'get_sfx',
+    description: 'Search sound effects library for audio assets matching a description or list all available sound effects. If query is omitted or "all", returns all 32 sound effects in the Ayphic SFX library.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'Sound effect query (e.g. "whoosh", "ding", "fail", "boom", "all" to list all sound effects).'
+        }
+      }
+    }
+  },
+  {
+    name: 'motion_designer',
+    description: 'Insert a custom React Remotion motion graphic overlay. DIRECT CODE & CONFIG SCHEMA TOOL: You (the MCP agent) generate the full Remotion component code in "code" and provide the configurable variables in "configSchema" so the user can easily customize colors, titles, and values from the UI Properties Panel.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: {
+          type: 'string',
+          description: 'REQUIRED: Full Remotion React component code (export const GeneratedMotion = (props) => { const frame = Remotion.useCurrentFrame(); const { fps = 30 } = Remotion.useVideoConfig(); ... return <div style={{...}}>...</div>; }). Use Remotion hooks and inline CSS styling.'
+        },
+        configSchema: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              key: { type: 'string', description: 'Variable key used in component (e.g. "title", "colorAccent", "count", "showBadge")' },
+              label: { type: 'string', description: 'Label shown in the UI properties panel (e.g. "Title Text", "Accent Color")' },
+              type: { type: 'string', enum: ['text', 'color', 'number', 'boolean'], description: 'Control type for the UI property panel' },
+              default: { description: 'Default value' },
+              min: { type: 'number', description: 'Min number (for number type)' },
+              max: { type: 'number', description: 'Max number (for number type)' },
+              step: { type: 'number', description: 'Step size (for number type)' }
+            },
+            required: ['key', 'type']
+          },
+          description: 'Configurable variables array shown in the UI properties panel for user customization.'
+        },
+        name: {
+          type: 'string',
+          description: 'Descriptive title of the motion graphic (e.g. "Minimalist Upload Card", "Subscriber Counter").'
+        },
+        start: {
+          type: 'number',
+          description: 'Start time on timeline in seconds (e.g. 4.0).'
+        },
+        dur: {
+          type: 'number',
+          description: 'Duration on timeline in seconds (default: 3.0).'
+        },
+        id: {
+          type: 'string',
+          description: 'Optional ID of existing motion element to update.'
+        }
+      },
+      required: ['code']
+    }
+  },
+  {
+    name: 'body_detection',
+    description: 'Perception tool: Detect human bodies, faces, postures, bounding boxes, full head-to-toe continuous skeletons, and exact coordinates on canvas.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        part: {
+          type: 'string',
+          enum: ['face', 'head', 'hair', 'neck', 'torso', 'chest', 'left_arm', 'right_arm', 'left_hand', 'right_hand', 'hands', 'left_leg', 'right_leg', 'legs', 'upper_body', 'lower_body', 'all'],
+          description: 'Specific anatomical part to extract coordinates for.'
+        },
+        frame: {
+          type: 'number',
+          description: 'Timeline frame number to analyze.'
+        },
+        timestamp: {
+          type: 'number',
+          description: 'Timestamp in seconds.'
+        }
+      }
+    }
+  },
+  {
+    name: 'check_face_overlap',
+    description: 'Check if timeline elements (CTAs, text, stickers) occlude any detected faces on the video canvas and return safe position coordinates.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        elementId: {
+          type: 'string',
+          description: 'Optional specific element ID to check.'
+        },
+        frame: {
+          type: 'number',
+          description: 'Timeline frame number.'
+        }
+      }
+    }
+  },
+  {
+    name: 'inspect_element',
+    description: 'Retrieve the complete raw JSON data structure of any timeline element by ID or name.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: {
+          type: 'string',
+          description: 'ID of the element to inspect.'
+        }
+      },
+      required: ['id']
+    }
+  },
+  {
+    name: 'get_transcript',
+    description: 'REQUIRED FIRST STEP FOR VIDEO CAPTIONS: Extract the authentic speech transcript with verbatim word-level timestamps (seconds) from the video/audio clip. When the user asks to add captions/subtitles to a video, you MUST call this tool first to obtain the authentic spoken words and timings from the video before calling captions.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        itemId: {
+          type: 'string',
+          description: 'Optional ID of the clip to transcribe (e.g. "clip2"). If omitted, automatically targets the main video.'
+        },
+        mediaUrl: {
+          type: 'string',
+          description: 'Optional direct media URL.'
+        }
+      }
+    }
+  },
+  {
+    name: 'captions',
+    description: 'Add, style, or remove animated captions/subtitles across the video timeline. DIRECT DATA TOOL: When adding captions for a video clip, you MUST first call `get_transcript` to get the real speech timestamps, then pass the `transcription` object directly here. You can also customize `template` ("beast", "hustle", "pop", "soft-ai", "karaoke"), or provide custom Remotion JSX `code`, or use `action: "delete"` to remove captions.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        transcription: {
+          type: 'object',
+          description: 'The authentic transcription object returned from get_transcript containing { text, words, segments, lines, captions }. Pass this directly from get_transcript.'
+        },
+        template: {
+          type: 'string',
+          enum: ['viral-stack', 'viral-stacked', 'stacked', 'beast', 'hustle', 'pop', 'soft-ai', 'gaming-stream', 'karaoke', 'grape', 'poppin', 'kinetic-01', 'kinetic-02', 'aarit', 'podcast'],
+          description: 'Visual subtitle preset theme. Recommended: "viral-stack" (stacked kinetic typography with dynamic sizing and slide-up), "beast" (MrBeast style bold uppercase highlight), "hustle" (green glow), "pop" (spring bounce).'
+        },
+        action: {
+          type: 'string',
+          enum: ['generate', 'delete', 'remove', 'clear'],
+          description: 'Action to perform. Use "generate" to add/update captions, or "delete"/"remove"/"clear" to remove all captions from the timeline.'
+        },
+        code: {
+          type: 'string',
+          description: 'Optional custom Remotion React JSX code template for rendering captions.'
+        },
+        words: {
+          type: 'array',
+          items: { type: 'object' },
+          description: 'Array of word-level timing objects [{ text: string, start: number, end: number }] from get_transcript.'
+        },
+        captions: {
+          type: 'array',
+          items: { type: 'object' },
+          description: 'Array of timed caption segments [{ text: string, start: number, end: number, words: array }] from get_transcript.'
+        },
+        fontSize: {
+          type: ['number', 'string'],
+          description: 'Font size (e.g. 72 or "72px").'
+        },
+        color: {
+          type: 'string',
+          description: 'Primary text color hex (e.g. "#ffffff").'
+        },
+        highlightColor: {
+          type: 'string',
+          description: 'Highlight active word color hex (e.g. "#ffff00" or "#4ade80").'
+        },
+        id: {
+          type: 'string',
+          description: 'Optional specific caption group ID to delete or modify.'
+        }
+      }
+    }
+  },
+  {
+    name: 'search_docs',
+    description: 'Search and retrieve Ayphic AI Video Editor documentation, capabilities catalog, schemas, 29 entrance animations, 13 exit animations, 9 loop animations, 11 filters, 20+ fonts, and tracks on-demand without bloating token context. Query with topics like "animations", "fonts", "filters", "text styling", "motion graphics", or "all". MANDATORY RULE: Whenever you need to apply an animation, styling, font, filter, transition, or property and are not 100% certain of the exact valid name, you MUST call this search_docs tool first before applying to avoid guessing or hallucinating non-existent properties.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'Topic or keyword to search (e.g. "animations", "fonts", "filters", "text", "all").'
+        },
+        category: {
+          type: 'string',
+          description: 'Optional category filter (e.g. "text", "animations", "filters", "shapes", "general").'
+        }
+      }
+    }
+  },
+  {
+    name: 'detect_beats',
+    description: 'Analyze an audio track or video clip to detect beats. Returns estimated BPM and a list of timestamps (seconds) where beats occur.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        itemId: { type: 'string', description: 'ID of the clip or sound element in the timeline to analyze (optional, defaults to primary sound track)' },
+        mediaUrl: { type: 'string', description: 'Direct URL or path of the audio file to analyze (optional)' }
+      }
+    }
+  },
+  {
+    name: 'glitch_reveal',
+    description: 'Freeze-frame glitch cutout reveal effect with background removal, white camera flash strobe, RGB split distortion, and automatic Shutter Modern sound effect.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        itemId: { type: 'string', description: 'ID of the video clip/overlay to apply the glitch reveal effect to.' },
+        timestamp: { type: ['number', 'string'], description: 'Timestamp in seconds or timestamp string where the freeze frame cutout occurs.' },
+        duration: { type: 'number', description: 'Duration of freeze-frame cutout in seconds.' },
+        style: { type: 'string', description: 'Visual glitch style preset.' },
+        includeShutter: { type: 'boolean', description: 'Automatically insert sound effect.' }
+      }
+    }
+  },
+  {
+    name: 'add_transition',
+    description: 'Add one or multiple video transition overlays between clips or across all cut points.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        preset: { type: 'string', description: 'Transition preset style ("filmBurn" or "paperCut").' },
+        clipIdA: { type: 'string', description: 'ID of the clip preceding the transition boundary.' },
+        clipIdB: { type: 'string', description: 'ID of the clip following the transition boundary.' },
+        atFrame: { type: 'number', description: 'Target timeline frame.' },
+        timestamp: { type: ['number', 'string'], description: 'Target timestamp.' },
+        placement: { type: 'string', description: 'Placement relative to cut point.' },
+        duration: { type: 'number', description: 'Custom duration.' }
+      }
+    }
+  },
+  {
+    name: 'remove_greenscreen',
+    description: 'Apply chroma-key (green screen removal) to a clip or overlay by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        itemId: { type: 'string', description: 'The ID of the clip or overlay to update' },
+        color: { type: 'string', description: 'Hex color to remove' },
+        strength: { type: 'number', description: 'Strength/threshold for removal' },
+        smoothness: { type: 'number', description: 'Edge smoothness value' }
+      },
+      required: ['itemId']
+    }
+  },
+  {
+    name: 'remove_silence',
+    description: 'Automatically detect and remove silent parts/gaps from a video clip on the timeline.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        clipId: { type: 'string', description: 'ID of the video clip' },
+        noiseThreshold: { type: 'number', description: 'Noise threshold in dB' },
+        minDuration: { type: 'number', description: 'Minimum duration of silence' }
+      },
+      required: ['clipId']
+    }
+  },
+  {
+    name: 'delete_track',
+    description: 'Permanently remove an entire track (like "V2", "A1") from the timeline.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        trackId: { type: ['string', 'array'], description: 'ID or array of IDs of tracks to delete' }
+      },
+      required: ['trackId']
+    }
+  }
+];
+
+/**
+ * Execute tool against Ayphic backend HTTP API
+ */
+async function executeAyphicTool(toolName, params) {
+  // Strip 'ayphic_' prefix to get internal tool name
+  const cleanName = toolName.startsWith('ayphic_') ? toolName.replace('ayphic_', '') : toolName;
+
+  // Map naming conventions
+  const toolNameMapping = {
+    'get_timeline': 'getTimeline',
+    'split_item': 'splitItem',
+    'trim_item': 'trimItem',
+    'delete_item': 'deleteItem',
+    'move_item': 'moveItem',
+    'add_item': 'addItem',
+    'update_property': 'updateProperty',
+    'set_position': 'setPosition',
+    'adjust_color': 'adjustColor',
+    'delete_track': 'deleteTrack',
+    'inspect_element': 'inspectElement',
+    'stock_search': 'stockSearch',
+    'get_sfx': 'getSFX',
+    'motion_designer': 'motionDesigner',
+    'body_detection': 'body_detection',
+    'check_face_overlap': 'checkFaceOverlap',
+    'get_transcript': 'getTranscript',
+    'captions': 'captions',
+    'search_docs': 'searchDocs',
+    'searchDocs': 'searchDocs',
+    'get_docs': 'searchDocs',
+    'detect_beats': 'detectBeats',
+    'glitch_reveal': 'glitchReveal',
+    'add_transition': 'addTransition',
+    'remove_greenscreen': 'removeGreenscreen',
+    'remove_silence': 'removeSilence'
+  };
+
+  const resolvedToolName = toolNameMapping[cleanName] || cleanName;
+
+  try {
+    const response = await fetch(`${API_BASE_URL}/api/mcp/execute-tool`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-mcp-client': 'claude-desktop'
+      },
+      body: JSON.stringify({
+        tool: resolvedToolName,
+        params: params || {}
+      })
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      return {
+        isError: true,
+        content: [
+          {
+            type: 'text',
+            text: `Ayphic Server Error (${response.status}): ${errorText}`
+          }
+        ]
+      };
+    }
+
+    const data = await response.json();
+    const isError = data.success === false || data.applied === false || !!data.error;
+    return {
+      isError,
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(data, null, 2)
+        }
+      ]
+    };
+  } catch (netErr) {
+    return {
+      isError: true,
+      content: [
+        {
+          type: 'text',
+          text: `Failed to connect to Ayphic backend at ${API_BASE_URL}. Ensure Ayphic server is running (npm run dev:server). Error: ${netErr.message}`
+        }
+      ]
+    };
+  }
+}
+
+/**
+ * Handle incoming JSON-RPC 2.0 message
+ */
+async function handleRpcMessage(msg) {
+  const { id, method, params } = msg;
+
+  switch (method) {
+    case 'initialize':
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: {
+          protocolVersion: '2024-11-05',
+          capabilities: {
+            tools: {
+              listChanged: false
+            },
+            resources: {},
+            prompts: {}
+          },
+          serverInfo: {
+            name: SERVER_NAME,
+            version: SERVER_VERSION
+          }
+        }
+      };
+
+    case 'notifications/initialized':
+      // Notification, no response needed
+      return null;
+
+    case 'ping':
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: {}
+      };
+
+    case 'tools/list':
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: {
+          tools: MCP_TOOLS
+        }
+      };
+
+    case 'tools/call': {
+      const toolName = params?.name;
+      const toolArguments = params?.arguments || {};
+      const executionResult = await executeAyphicTool(toolName, toolArguments);
+
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: executionResult
+      };
+    }
+
+    case 'prompts/list':
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: {
+          prompts: []
+        }
+      };
+
+    case 'resources/list':
+      return {
+        jsonrpc: '2.0',
+        id,
+        result: {
+          resources: [
+            {
+              uri: 'ayphic://timeline/active',
+              name: 'Active Video Timeline',
+              description: 'Real-time JSON state of the current video project in Ayphic Editor',
+              mimeType: 'application/json'
+            },
+            {
+              uri: 'ayphic://docs/capabilities',
+              name: 'Ayphic Video Editor Full Capabilities Documentation',
+              description: 'Comprehensive schema & properties reference for text, shapes, motions, SFX, 29 entrance animations, 13 exit animations, 9 loop animations, 11 filters, and 20+ fonts.',
+              mimeType: 'text/markdown'
+            },
+            {
+              uri: 'ayphic://docs/summary',
+              name: 'Ayphic Master Capabilities Catalog',
+              description: 'Concise master catalog of all supported features, animations, filters, transitions, fonts, and tracks.',
+              mimeType: 'text/markdown'
+            }
+          ]
+        }
+      };
+
+    case 'resources/read': {
+      const uri = params?.uri;
+      if (uri === 'ayphic://timeline/active') {
+        const timelineResult = await executeAyphicTool('ayphic_get_timeline', {});
+        return {
+          jsonrpc: '2.0',
+          id,
+          result: {
+            contents: [
+              {
+                uri,
+                mimeType: 'application/json',
+                text: timelineResult.content?.[0]?.text || '{}'
+              }
+            ]
+          }
+        };
+      } else if (uri === 'ayphic://docs/capabilities') {
+        let content = '# Ayphic AI Video Editor Capabilities\nDocumentation not found on disk.';
+        if (fs.existsSync(DOCS_PATH)) {
+          content = fs.readFileSync(DOCS_PATH, 'utf8');
+        }
+        return {
+          jsonrpc: '2.0',
+          id,
+          result: {
+            contents: [
+              {
+                uri,
+                mimeType: 'text/markdown',
+                text: content
+              }
+            ]
+          }
+        };
+      } else if (uri === 'ayphic://docs/summary') {
+        const docResult = await executeAyphicTool('search_docs', { query: 'summary' });
+        const summaryText = docResult.content?.[0]?.text || '';
+        return {
+          jsonrpc: '2.0',
+          id,
+          result: {
+            contents: [
+              {
+                uri,
+                mimeType: 'text/markdown',
+                text: summaryText
+              }
+            ]
+          }
+        };
+      }
+      return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+          code: -32602,
+          message: `Resource not found: ${uri}`
+        }
+      };
+    }
+
+    default:
+      if (id !== undefined && id !== null) {
+        return {
+          jsonrpc: '2.0',
+          id,
+          error: {
+            code: -32601,
+            message: `Method '${method}' not found`
+          }
+        };
+      }
+      return null;
+  }
+}
+
+/**
+ * Main stdio loop
+ */
+function startStdioServer() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    terminal: false
+  });
+
+  rl.on('line', async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+
+    try {
+      const parsed = JSON.parse(trimmed);
+      const response = await handleRpcMessage(parsed);
+      if (response) {
+        process.stdout.write(JSON.stringify(response) + '\n');
+      }
+    } catch (parseErr) {
+      process.stdout.write(JSON.stringify({
+        jsonrpc: '2.0',
+        id: null,
+        error: {
+          code: -32700,
+          message: `Parse error: ${parseErr.message}`
+        }
+      }) + '\n');
+    }
+  });
+}
+
+startStdioServer();

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "ayphic-mcp-server",
+  "version": "1.1.0",
+  "description": "Model Context Protocol (MCP) Server for Ayphic AI Video Editor",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "ayphic-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "video-editor",
+    "ayphic"
+  ],
+  "author": "Ayphic",
+  "license": "MIT"
+}