Excalidraw MCP Server
Excalidraw MCP 서버: LLM 통합을 위한 강력한 드로잉 API
Excalidraw 다이어그램 및 도면과의 원활한 상호 작용을 지원하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 구조화되고 개발자 친화적인 API를 통해 LLM(대규모 언어 모델)이 Excalidraw 도면을 생성, 수정, 쿼리 및 조작할 수 있도록 지원합니다.
특징
전체 엑스칼리드로우 요소 제어
사각형, 타원, 마름모, 텍스트, 화살표 등의 모든 Excalidraw 요소를 만들고, 업데이트하고, 삭제하고, 쿼리합니다. 여기에는 다음이 지원됩니다.위치(
x,y)치수(
width,height)스타일링(
backgroundColor,strokeColor,strokeWidth,roughness,opacity)텍스트(
text,fontSize,fontFamily)선 기하학(
points)잠금(
locked플래그)
고급 요소 조작
요소를 그룹화, 그룹 해제, 정렬, 분배, 잠금 및 잠금 해제합니다.Scene 및 AppState 관리
씬 수준 상태를 추적하고 수정합니다:
theme,viewBackgroundColor,viewport(스크롤 및 확대/축소),selectedElements,groups.모든 요소 또는 개별 장면 속성의 라이브러리를 검색합니다.
장면 저장
현재 장면(요소 + appState)을 디스크의.excalidraw파일로 내보냅니다.자원 관리
장면 정보, 요소 라이브러리, 테마 및 원시 요소 데이터에 액세스하여 수정합니다.쉬운 통합
Claude Desktop, Cursor 및 MCP를 지원하는 다른 LLM 플랫폼과 호환됩니다.도커 지원
종속성 없는 설치를 위한 간단한 컨테이너화된 배포.
Related MCP server: Excalidraw MCP Server
API 도구 참조
요소 생성 및 수정
create_element
새로운 Excalidraw 요소를 만듭니다.
입력
지엑스피1
산출
{ "id": "<generated‑id>", "type": "<element type>", "created": true }
update_element
기존 요소의 속성을 업데이트합니다.
입력
{ "id": "<element id>", }산출
{ "id": "<element id>", "updated": true, "version": <new‑version‑number> }
delete_element
장면에서 요소를 제거합니다.
입력
{ "id": "<element id>" }산출
{ "id": "<element id>", "deleted": true }
query_elements
선택적 필터와 일치하는 요소를 나열합니다.
입력
{ "type": "<element type>", "filter": { "<prop>": <value> } }산출
[ { /* element objects */ } … ]
자원 관리
get_resource
장면이나 라이브러리 정보를 검색합니다.
입력
{ "resource": "scene"|"library"|"theme"|"elements" }산출
장면 →
{ theme, viewport: {x,y,zoom}, selectedElements: […] }라이브러리 / 요소 →
{ elements: [ … ] }테마 →
{ theme: "light"|"dark" }
요소 구성
group_elements / ungroup_elements
요소 컬렉션을 그룹화하거나 그룹화 해제합니다.
입력
{ "elementIds": ["id1","id2",…] } { "groupId": "<group id>" }산출
{ "groupId": "<new‑id>", "elementIds": […], "ungrouped": true? }
align_elements
여러 요소를 지정된 가장자리나 중앙에 맞춥니다.
입력
{ "elementIds": […], "alignment": "left"|"center"|"right"|"top"|"middle"|"bottom" }산출
{ aligned: true, elementIds: […], alignment: "<alignment>" }
distribute_elements
요소들을 수평 또는 수직으로 균등하게 배치합니다.
입력
{ "elementIds": […], "direction": "horizontal"|"vertical" }산출
{ distributed: true, elementIds: […], direction: "<direction>" }
lock_elements / unlock_elements
요소 편집을 방지하거나 허용합니다.
입력
{ "elementIds": [… ] }산출
{ locked: true|false, elementIds: […] }
장면 관리
save_scene
현재 장면(요소 + 앱 상태)을 .excalidraw 파일로 내보냅니다.
입력
{ "filename": "<optional, must end with .excalidraw>" }산출
Scene saved successfully to <filename>오류 메시지가 표시됩니다.
통합 예제
클로드 데스크탑
"mcpServers": {
"excalidraw": {
"command": "node",
"args": ["src/index.js"],
"env": {
"LOG_LEVEL": "info",
"DEBUG": "false"
}
}
}커서
.cursor/mcp.json 생성합니다.
{
"mcpServers": {
"excalidraw": {
"command": "node",
"args": ["/absolute/path/to/mcp_excalidraw/src/index.js"],
"env": { "LOG_LEVEL": "info", "DEBUG": "false" }
}
}
}도커
docker run -i --rm mcp/excalidraw또는 MCP 구성에서:
"mcpServers": {
"excalidraw": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/excalidraw"],
"env": { "LOG_LEVEL": "info", "DEBUG": "false" }
}
}설치 가이드
# Install dependencies
npm install
# Run development server
npm start도커
docker build -t mcp/excalidraw .
docker run -i --rm mcp/excalidraw구성 옵션
.env 또는 컨테이너의 환경 변수를 통해 설정:
LOG_LEVEL— 로깅 수준(기본값:"info")DEBUG— 디버그 모드("true"/"false", 기본값:"false")DEFAULT_THEME— 기본 UI 테마("light"/"dark", 기본값:"light")
사용 예
사각형 만들기 및 잠금
{"type":"rectangle","x":50,"y":50,"width":100,"height":80,"backgroundColor":"#f3f3f3","strokeColor":"#333","locked":true}
{ "id":"abc123","type":"rectangle","created":true }
{"elementIds":["abc123"]}장면을 파일로 저장
{"filename":"my_drawing.excalidraw"}
"Scene saved successfully to my_drawing.excalidraw"Available Tools
12 toolsalign_elementsC
Align elements to a specific position
Inputs: elementIds (required), alignment (required).
create_elementC
Create a new Excalidraw element
Inputs: type (required), x (required), y (required), width, +9 more.
delete_elementC
Delete an Excalidraw element
Inputs: id (required).
distribute_elementsD
Distribute elements evenly
Inputs: elementIds (required), direction (required).
get_resourceD
Get an Excalidraw resource
Inputs: resource (required).
group_elementsC
Group multiple elements together
Inputs: elementIds (required).
lock_elementsB
Lock elements to prevent modification
Inputs: elementIds (required).
query_elementsC
Query Excalidraw elements with optional filters
Inputs: type, filter.
save_sceneB
Saves the current Excalidraw elements and scene state to a .excalidraw file.
Inputs: filename.
ungroup_elementsB
Ungroup a group of elements
Inputs: groupId (required).
unlock_elementsB
Unlock elements to allow modification
Inputs: elementIds (required).
update_elementC
Update an existing Excalidraw element
Inputs: id (required), type, x, y, +10 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool has a clearly distinct purpose targeting specific actions on Excalidraw elements or resources. There is no overlap between creation, deletion, updating, querying, grouping, locking, alignment, distribution, or file operations. The descriptions reinforce these distinct roles, making tool selection unambiguous.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., create_element, delete_element, group_elements). The naming convention is uniform throughout the set, with verbs clearly indicating actions and nouns specifying targets, making the tools predictable and easy to understand.
With 12 tools, the server is well-scoped for managing Excalidraw diagrams, covering essential operations like CRUD for elements, grouping, locking, alignment, distribution, querying, and file saving. Each tool serves a distinct and necessary function, with no redundancy or excessive complexity.
The tool set provides complete coverage for the Excalidraw domain, including full CRUD lifecycle for elements (create, query, update, delete), grouping/ungrouping, locking/unlocking, alignment/distribution, and scene saving. There are no obvious gaps; agents can perform all core diagram editing and management tasks without dead ends.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- AlicenseBqualityBmaintenanceA Model Context Protocol server that enables LLMs to create, modify, and manipulate Excalidraw diagrams through a structured API.115,646 npm2,645MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that provides API functionality for creating, managing, and exporting Excalidraw drawings in various formats like SVG, PNG, and JSON.845MIT
- AlicenseNot gradedqualityNot gradedmaintenanceA server that implements the Model Context Protocol (MCP), providing an interface for LLM applications to generate mermaid.js visualizations and diagrams.MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables AI agents to programmatically create, modify, and manage Figma documents via a WebSocket bridge and Figma plugin.116MIT