Excalidraw MCP

🚀 Excalidraw MCP Server

This is a server that provides Model Context Protocol (MCP) services for Excalidraw, offering API functionality for operating Excalidraw drawings.

🚀 Quick Start

This server offers Model Context Protocol (MCP) services for Excalidraw, providing APIs to manipulate Excalidraw drawings.

✨ Features

• Create, read, update, and delete Excalidraw drawings.
• Export drawings in SVG, PNG, and JSON formats.
• Simple file-based storage system.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/excalidraw-mcp.git
cd excalidraw-mcp

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Basic Usage

Start the server

npm start

API Endpoints

The server provides the following tools:

Drawing Management

• create_drawing: Create a new Excalidraw drawing.
• get_drawing: Get an Excalidraw drawing by ID.
• update_drawing: Update an Excalidraw drawing by ID.
• delete_drawing: Delete an Excalidraw drawing by ID.
• list_drawings: List all Excalidraw drawings.

Export Operations

• export_to_svg: Export an Excalidraw drawing to SVG.
• export_to_png: Export an Excalidraw drawing to PNG.
• export_to_json: Export an Excalidraw drawing to JSON.

📚 Documentation

Project Structure

excalidraw-mcp/
├── src/
│   ├── common/
│   │   └── errors.ts
│   └── operations/
│       ├── drawings.ts
│       └── export.ts
├── index.ts
├── package.json
├── tsconfig.json
└── README.md

Build

npm run build

Run in Development Mode

npm run dev

📄 License

MIT