Excalidraw MCP Server

Instructions

Implementation Reference

• src/index.ts:795-806 (handler)

  Handler for distribute_elements tool: parses input using DistributeElementsSchema, logs the action (placeholder implementation), and returns a success result.

  case 'distribute_elements': {
    const params = DistributeElementsSchema.parse(args);
    const { elementIds, direction } = params;
    
    // Implementation would distribute elements based on the specified direction
    logger.info('Distributing elements', { elementIds, direction });
    
    const result = { distributed: true, elementIds, direction };
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
    };
  }

• src/index.ts:217-220 (schema)

  Zod schema for validating distribute_elements tool input parameters: array of element IDs and direction (horizontal or vertical).

  const DistributeElementsSchema = z.object({
    elementIds: z.array(z.string()),
    direction: z.enum(['horizontal', 'vertical'])
  });

• src/index.ts:371-388 (registration)

  Tool registration in the tools array, defining name, description, and inputSchema for distribute_elements.

  {
    name: 'distribute_elements',
    description: 'Distribute elements evenly',
    inputSchema: {
      type: 'object',
      properties: {
        elementIds: { 
          type: 'array',
          items: { type: 'string' }
        },
        direction: { 
          type: 'string', 
          enum: ['horizontal', 'vertical'] 
        }
      },
      required: ['elementIds', 'direction']
    }
  },