Skip to main content
Glama
thiendt1608

excalidraw-mcp

by thiendt1608

Excalidraw MCP Server (совместим со спецификацией Excalidraw v2)

MCP-сервер (Model Context Protocol) для создания и управления диаграммами Excalidraw, обновлённый в соответствии с официальной спецификацией Excalidraw v2.

Возможности

Основные инструменты для элементов

Инструмент

Описание

create_element

Создать один элемент Excalidraw

create_elements_batch

Создать несколько элементов одним вызовом

update_element

Обновить существующий элемент по ID

delete_element

Удалить элемент по ID

query_elements

Запросить элементы по типу или пользовательским фильтрам

clear_canvas

Очистить все элементы с холста

Файловые операции

Инструмент

Описание

export_file

Экспортировать холст в файл .excalidraw

import_file

Импортировать файл .excalidraw на холст

get_scene_json

Получить полный JSON сцены

Элементы библиотеки (официальные наборы иконок Excalidraw)

Инструмент

Описание

list_library_items

Поиск или список элементов во всех установленных библиотеках (query, library, limit)

insert_library_item

Вставить иконку в позицию с необязательным масштабом (itemId, x, y, scale, library)

Установленные официальные библиотеки (499+ иконок):

  1. AWS Architecture Icons (aws-architecture-icons): 249 иконок (CloudSearch, EMR, DynamoDB, S3, EC2, Lambda, VPC, RDS, Kinesis и др.)

  2. Google Icons (google-icons): 139 иконок (Anthos, BigQuery, Compute Engine, Cloud Run, GKE, Firestore и др.)

  3. System Design Components (system-design-components): 24 элемента (Application server, Multi-instance server, Load Balancer и др.)

  4. Shapes for UML & ER Diagrams (uml-er-diagrams): 21 элемент (Entities, Relations, Connectors, Shapes)

  5. Software Logos (software-logos): 18 иконок (Docker, JSON, Git, логотипы баз данных и др.)

  6. Architecture Diagram Components (architecture-diagram-components): 11 компонентов (Slack, Docker, GitHub, VPC, Subnets)

  7. Software Architecture (software-architecture): 7 основных элементов диаграмм

  8. Robots (robots): 7 иллюстрированных фигур роботов

  9. Built-in Common Icons (built-in): 23 лёгкие встроенные иконки

Автоматическая раскладка блок-схем

Инструмент

Описание

create_flowchart

Создать блок-схему с автоматической раскладкой DagreJS

Поддерживаемые раскладки: Top-Bottom (TB), Left-Right (LR), Bottom-Top (BT), Right-Left (RL) Формы узлов: Rectangle, Ellipse, Diamond

// Update an existing element
update_element({ id: "mybox1", strokeColor: "#099268", text: "Updated!", width: 200 })

// Query elements by filter
query_elements({ filter: { type: "rectangle" } })

// Export to file
export_file({ filePath: "docs/architecture.excalidraw" })

Related MCP server: excalidraw-architect-mcp

Настройка

Добавьте в файл настроек MCP (например, claude_desktop_config.json, .cursor/mcp.json или ~/.omp/agent/mcp.json):

{
  "mcpServers": {
    "excalidraw": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/excalidraw-mcp/src/cli.js"]
    }
  }
}

Related MCP Connectors

Related MCP Servers