yctimlin/mcp_excalidraw

어떤 프로젝트인가요?

핵심 기능

• 01실시간 Excalidraw 캔버스에서 요소 단위로 생성, 조회, 업데이트, 삭제를 지원합니다.
• 02헤드리스 스크린샷과 PNG/SVG 내보내기를 지원해 에이전트가 다이어그램을 직접 확인할 수 있습니다.
• 03정렬, 분산, 그룹화, 잠금, 복제를 위한 레이아웃 도구를 제공합니다.
• 04장면을 되돌릴 수 있도록 이름이 지정된 스냅샷과 복원 기능을 제공합니다.
• 05Mermaid를 캔버스로 변환하고 excalidraw.com으로 연결되는 암호화된 공유 링크를 생성합니다.
• 06CLI, MCP 서버 또는 REST API로 사용할 수 있습니다.

활용 사례

• 코딩 에이전트가 코드베이스의 아키텍처 다이어그램과 순서도를 그리도록 합니다.
• .excalidraw 다이어그램을 저장소로 내보내 코드와 함께 버전 관리합니다.
• Obsidian 보관함 안에서 다이어그램을 생성하고 관리합니다.
• 브라우저를 실행하지 않고 CI에서 커밋된 .excalidraw 파일을 PNG로 렌더링합니다.

빠른 시작

1. 1

   npx로 캔버스 서버 시작하기

   npx -y mcp-excalidraw-server start
2. 2

   CLI로 테스트 다이어그램 그리기

   npx -y mcp-excalidraw-server describe
3. 3

   에이전트 스킬을 skills 디렉터리에 설치하기

   npx -y mcp-excalidraw-server install-skill --dir <skills-root>

사용 전 알아둘 점

• !Mermaid 변환을 하려면 캔버스가 열린 브라우저 탭이 필요합니다.
• !캔버스 페이지는 esm.sh CDN에서 Excalidraw 폰트를 불러옵니다.

포함된 컬렉션

토픽

자주 묻는 질문

mcp_excalidraw은(는) 무엇인가요?

AI 코딩 에이전트가 실시간 Excalidraw 캔버스에서 다이어그램을 그리고, 스크린샷을 찍고, 편집 및 내보내기할 수 있게 해주는 MCP 서버, CLI, 에이전트 스킬입니다. mcp-excalidraw-server를 사용하면 AI 에이전트가 실시간 로컬 캔버스에서 Excalidraw 다이어그램을 프로그래밍 방식으로 만들고 편집할 수 있습니다. 에이전트는 개별 요소를 추가하고, 조회하고, 업데이트하고, 삭제할 수 있으며, 정렬·분산·그룹 작업으로 요소를 배치할 수도 있습니다. 텍스트 장면 설명이나 렌더링된 스크린샷을 통해 작업 결과를 직접 확인할 수 있습니다.

mcp_excalidraw은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp_excalidraw은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp_excalidraw은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mcp_excalidraw의 마지막 커밋은 2026년 10월 30일입니다.

mcp_excalidraw은(는) 어디에 사용할 수 있나요?

코딩 에이전트가 코드베이스의 아키텍처 다이어그램과 순서도를 그리도록 합니다. .excalidraw 다이어그램을 저장소로 내보내 코드와 함께 버전 관리합니다. Obsidian 보관함 안에서 다이어그램을 생성하고 관리합니다. 브라우저를 실행하지 않고 CI에서 커밋된 .excalidraw 파일을 PNG로 렌더링합니다.

mcp_excalidraw는 어떻게 설치하나요?

npx로 캔버스 서버 시작하기: npx -y mcp-excalidraw-server start CLI로 테스트 다이어그램 그리기: npx -y mcp-excalidraw-server describe 에이전트 스킬을 skills 디렉터리에 설치하기: npx -y mcp-excalidraw-server install-skill --dir <skills-root>

mcp_excalidraw은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yctimlin/mcp_excalidraw