Excalidraw MCP 서버: LLM 통합을 위한 강력한 드로잉 API
Excalidraw 다이어그램 및 도면과의 원활한 상호작용을 지원하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 구조화되고 개발자 친화적인 API를 통해 LLM(대규모 언어 모델)이 Excalidraw 도면을 생성, 수정, 쿼리 및 조작할 수 있도록 지원합니다.
특징
- 전체 Excalidraw 요소 제어 : 모든 Excalidraw 요소를 생성, 업데이트, 삭제 및 쿼리합니다.
- 고급 요소 조작 : 요소 그룹화, 정렬, 분산, 잠금 및 잠금 해제
- 리소스 관리 : 장면 정보, 라이브러리, 테마 및 요소에 액세스하고 수정합니다.
- 간편한 통합 : Claude Desktop 및 기타 LLM 플랫폼과 호환됩니다.
- Docker 지원 : 컨테이너화 옵션을 통한 간단한 배포
API 도구 참조
요소 생성 및 수정
- 생성_요소
- 새로운 Excalidraw 요소(사각형, 타원, 마름모 등)를 만듭니다.
- 필수 입력:
type , x , y 좌표 - 선택 입력: 치수, 색상, 스타일 속성
- 업데이트_요소
- ID로 기존 Excalidraw 요소 업데이트
- 필수 입력: 업데이트할 요소의
id - 선택 입력: 수정할 요소 속성
- 삭제_요소
- Excalidraw 요소 삭제
- 필수 입력: 삭제할 요소의
id
- 쿼리_요소
- 선택적 필터링이 있는 쿼리 요소
- 선택 입력:
type 유형별 필터링, 키-값 쌍을 사용한 객체 filter
자원 관리
- get_resource
- 장면 정보나 모든 요소와 같은 특정 리소스를 가져옵니다.
- 필수 입력:
resource 유형(장면, 라이브러리, 테마, 요소)
요소 구성
- 그룹_요소
- 여러 요소를 함께 그룹화합니다
- 필수 입력: 그룹화할 요소 ID의
elementIds 배열
- 요소 그룹 해제
- 요소 그룹 해제
- 필수 입력: 그룹 해제할 그룹의
groupId
- 정렬_요소
- 지정된 정렬을 기준으로 여러 요소를 정렬합니다.
- 필수 입력:
elementIds 배열 및 alignment (왼쪽, 중앙, 오른쪽, 위쪽, 중간, 아래쪽)
- 분배_요소
- 공간을 가로질러 요소를 균등하게 분배합니다.
- 필수 입력:
elementIds 배열 및 direction (수평 또는 수직)
- 잠금_요소
- 수정을 방지하기 위해 요소를 잠그세요
- 필수 입력: 잠글 요소의
elementIds 배열
- 잠금 해제_요소
- 수정을 허용하려면 요소를 잠금 해제하세요.
- 필수 입력: 잠금 해제할 요소의
elementIds 배열
Claude Desktop과 통합
Claude Desktop 애플리케이션과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.
지엑스피1
커서와의 통합
Cursor와 함께 이 서버를 사용하려면 다음 구성으로 작업 공간에 .cursor/mcp.json 파일을 만드세요.
{
"mcpServers": {
"excalidraw": {
"command": "node",
"args": [
"/path/to/your/directory/mcp_excalidraw/src/index.js"
],
"env": {
"LOG_LEVEL": "info",
"DEBUG": "false"
}
}
}
}
다음 사항을 확인하세요.
/path/to/your/directory mcp_excalidraw 설치의 실제 절대 경로로 바꾸세요..cursor 디렉토리가 없으면 생성하세요.index.js 경로가 올바르고 파일이 존재하는지 확인하세요.
Docker 통합
{
"mcpServers": {
"excalidraw": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/excalidraw"],
"env": {
"LOG_LEVEL": "info",
"DEBUG": "false"
}
}
}
}
설치 가이드
NPM 설치
# Install dependencies
npm install
# Start the server
npm start
도커 설치
# Build the Docker image
docker build -t mcp/excalidraw .
# Run the container
docker run -i --rm mcp/excalidraw
구성 옵션
다음 환경 변수를 사용하여 서버를 구성할 수 있습니다.
LOG_LEVEL - 로깅 수준을 설정합니다(기본값: "info")DEBUG - 디버그 모드 활성화(기본값: "false")DEFAULT_THEME - 기본 테마를 설정합니다(기본값: "light")
사용 예
Excalidraw MCP 서버를 사용하는 방법에 대한 몇 가지 실제 예는 다음과 같습니다.
사각형 요소 만들기
{
"type": "rectangle",
"x": 100,
"y": 100,
"width": 200,
"height": 100,
"backgroundColor": "#ffffff",
"strokeColor": "#000000",
"strokeWidth": 2,
"roughness": 1
}
특정 요소 쿼리
{
"type": "rectangle",
"filter": {
"strokeColor": "#000000"
}
}
여러 요소 그룹화
{
"elementIds": ["elem1", "elem2", "elem3"]
}
특허
이 Excalidraw MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하십시오.