Excalidraw MCP 서버: LLM 통합을 위한 강력한 드로잉 API

Excalidraw 다이어그램 및 도면과의 원활한 상호작용을 지원하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 구조화되고 개발자 친화적인 API를 통해 LLM(대규모 언어 모델)이 Excalidraw 도면을 생성, 수정, 쿼리 및 조작할 수 있도록 지원합니다.

특징

• 전체 Excalidraw 요소 제어 : 모든 Excalidraw 요소를 생성, 업데이트, 삭제 및 쿼리합니다.

• 고급 요소 조작 : 요소 그룹화, 정렬, 분산, 잠금 및 잠금 해제

• 리소스 관리 : 장면 정보, 라이브러리, 테마 및 요소에 액세스하고 수정합니다.

• 간편한 통합 : Claude Desktop 및 기타 LLM 플랫폼과 호환됩니다.

• Docker 지원 : 컨테이너화 옵션을 통한 간단한 배포

Related MCP server: Excalidraw MCP Server

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"
      }
    }
  }
}

다음 사항을 확인하세요.

1. /path/to/your/directory mcp_excalidraw 설치의 실제 절대 경로로 바꾸세요.

2. .cursor 디렉토리가 없으면 생성하세요.

3. 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 파일을 참조하십시오.