Excalidraw MCP Server (Excalidraw v2 Spec Compliant)

Excalidraw 다이어그램을 생성하고 관리하기 위한 MCP(Model Context Protocol) 서버로, 공식 Excalidraw v2 사양을 따르도록 업그레이드되었습니다.

기능

핵심 요소 도구

파일 작업

라이브러리 항목(공식 Excalidraw 아이콘 팩)

설치된 공식 라이브러리(499+ 아이콘):

1. AWS Architecture Icons (aws-architecture-icons): 249개 아이콘(CloudSearch, EMR, DynamoDB, S3, EC2, Lambda, VPC, RDS, Kinesis 등)

2. Google Icons (google-icons): 139개 아이콘(Anthos, BigQuery, Compute Engine, Cloud Run, GKE, Firestore 등)

3. System Design Components (system-design-components): 24개 항목(Application server, Multi-instance server, Load Balancer 등)

4. Shapes for UML & ER Diagrams (uml-er-diagrams): 21개 항목(Entities, Relations, Connectors, Shapes)

5. Software Logos (software-logos): 18개 아이콘(Docker, JSON, Git, Database 로고 등)

6. Architecture Diagram Components (architecture-diagram-components): 11개 구성 요소(Slack, Docker, GitHub, VPC, Subnets)

7. Software Architecture (software-architecture): 7개 핵심 다이어그램 요소

8. Robots (robots): 7개 일러스트 로봇 그림

9. Built-in Common Icons (built-in): 23개 경량 기본 아이콘

자동 레이아웃 순서도

지원 레이아웃: Top-Bottom(TB), Left-Right(LR), Bottom-Top(BT), Right-Left(RL) 노드 모양: Rectangle, Ellipse, Diamond

// Update an existing element
update_element({ id: "mybox1", strokeColor: "#099268", text: "Updated!", width: 200 })

// Query elements by filter
query_elements({ filter: { type: "rectangle" } })

// Export to file
export_file({ filePath: "docs/architecture.excalidraw" })

Related MCP server: excalidraw-architect-mcp

설정

MCP 설정 파일(예: claude_desktop_config.json, .cursor/mcp.json, 또는 ~/.omp/agent/mcp.json)에 추가하세요:

{
  "mcpServers": {
    "excalidraw": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/excalidraw-mcp/src/cli.js"]
    }
  }
}