YM

yctimlin/mcp_excalidraw

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

2.6천 stars 294 forks 품질 90 트렌드 49MIT

MCP 서버와 Excalidraw용 Claude 코드 스킬 — 실시간 캔버스 동기화가 가능한 AI 에이전트를 통해 도표를 생성, 편집, 내보내는 프로그래밍 캐버스 툴킷.

개요

라이브 Excalidraw 캔버스를 실행하고 AI 에이전트로부터 제어하세요. 이 저장소는 다음과 같은 기능을 제공합니다: - : 모델 컨텍스트 프로토콜(Claude Desktop, 커서, Codex CLI 등)을 통한 연결 - : Claude Code, Codex CLI 및 기타 기술 지원 에이전트용 휴대용 기술 키워드: Excalidraw 에이전트 스킬, Excalidraw MCP 서버, AI 다이어그램 작성, Claude 코드 스킬, Codex CLI 스킬, Claude Desktop MCP, 커서 MCP, Mermaid에서 Excalidraw까지. AI 에이전트는 단일 프롬프트(4배속)로 완전한 아키텍처 다이어그램을 생성합니다. 유튜브에서 전체 영상을 시청하세요 이 저장소에는 두 개의 별도 프로세스가 포함되어 있습니다: - 캔버스 서버: 웹 UI + REST API + WebSocket 업데이트 (기본 http://127.0.0.1:3000) - MCP 서버: MCP 도구를 stdio에서 노출; EXPRESS_SERVER_URL를 통해 캔버스와 동기화 Excalidraw는 이제 공식 MCP를 보유하고 있는데, 이는 빠르고 빠르게 다이어그램 생성을 채팅에서 인라인으로 렌더링하는 데 훌륭합니다. 우리는 다른 문제를 해결합니다. — 공식 MCP는 도표를 생성합니다.

개요(AI 번역)

mcp-excalidraw-server는 AI 에이전트에게 라이브 Excalidraw 캔버스를 제공해 사용자가 직접 그리고, 살펴보고, 다듬어 저장소에 저장할 수 있습니다. 에이전트는 아키텍처 다이어그램과 플로우차트를 프로그래밍적으로 생성하고, 스크린샷을 통해 자신의 작업을 확인하며 레이아웃 문제를 수정하고, 코드 옆에 커밋할 수 있는 .excalidraw 파일을 내보냅니다.

한 캔버스, 세 가지 운전 방법:

  • 에이전트 스킬 + CLI — 코딩 에이전트(Claude Code, Codex CLI, 커서, OpenCode) 추천: npx -y mcp-excalidraw-server . 설정 0, 캔버스 자동 시작, 컴포즈블 JSON 입출력 완료.
  • MCP 서버 — 모든 모델 컨텍스트 프로토콜 클라이언트(Claude Desktop, 커서, Codex CLI, Antigravity 등)를 위한 26개의 도구를 지원합니다. MCP 2026-07-28 (server/discover, 요청당 _meta 엔벨로프, 악수 없이 도구 호출) 말하며, initialize로 열리는 2025년 당시 클라이언트와도 호환됩니다.
  • REST API — LangChain 및 커스텀 프레임워크용 일반 HTTP

코어 드로잉은 로컬에서 실행됩니다(Node ≥ 20, MIT 라이선스 제공) — API 키나 계정이 없습니다. 머메이드 변환은 로컬 브라우저 캔버스에서 실행됩니다; share는 선택 사항이며 암호화된 장면을 excalidraw.com 에 업로드합니다. 캔버스 페이지는 esm.sh CDN에서 Excalidraw의 글꼴을 불러옵니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Excalidraw MCP Server, CLI & Agent Skill

mcp-excalidraw-server gives AI agents a live Excalidraw canvas they can draw on, look at, refine, and save into your repo. Your agent creates architecture diagrams and flowcharts programmatically, sees its own work via screenshots, fixes layout problems, and exports .excalidraw files you can commit next to your code.

One canvas, three ways to drive it:

  • Agent Skill + CLI — recommended for coding agents (Claude Code, Codex CLI, Cursor, OpenCode): npx -y mcp-excalidraw-server . Zero config, auto-starts the canvas, composable JSON in/out.
  • MCP Server — 26 tools over stdio for any Model Context Protocol client (Claude Desktop, Cursor, Codex CLI, Antigravity, …). Speaks MCP 2026-07-28 (server/discover, per-request _meta envelope, tool calls without a handshake) and stays compatible with 2025-era clients that open with initialize.
  • REST API — plain HTTP for LangChain and custom frameworks.

Core drawing runs locally (Node ≥ 20, MIT licensed) — no API keys or accounts. Mermaid conversion runs in the local browser canvas; share is optional and uploads an encrypted scene to excalidraw.com. The canvas page loads Excalidraw’s fonts from the esm.sh CDN.

Demo

AI agent creates a complete architecture diagram from a single prompt (4x speed). Watch full video on YouTube

Table of Contents

GitHub에서 전체 README 보기

설치

npx -y mcp-excalidraw-server
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "excalidraw": { "command": "npx", "args": ["-y", "mcp-excalidraw-server"], "env": { "EXPRESS_SERVER_URL": "http://127.0.0.1:13000", "EXCALIDRAW_NO_AUTOSTART": "1" } } } }