hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Supports containerized deployment of the MCP server for simplified integration and consistent environment.
Enables creation, modification, and manipulation of Excalidraw diagrams, including element control, grouping, alignment, and resource management.
Provides installation and dependency management through npm, allowing users to easily set up and run the MCP server.

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

LLM이 구조화된 API를 통해 Excalidraw 다이어그램을 생성, 수정 및 조작할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

Excalidraw MCP Server