Excalidraw MCP App Server

MCP-сервер, который позволяет рисовать диаграммы от руки (hand-drawn) прямо в чате. Сервер передаёт векторные изображения Excalidraw с плавным управлением камерой и возможностью полноэкранного редактирования.

Установка

Работает с любым клиентом, поддерживающим MCP Apps: Claude, ChatGPT, VS Code, Goose и другие. Если что-то не работает, создайте issue.

Удалённый сервер (рекомендуется)

Просто укажите URL: https://mcp.excalidraw.com

Для приложений без официальной интеграции — добавьте кастомный MCP-коннектор (название зависит от приложения).

Локальная установка

Вариант A: Готовое расширение

1. Скачайте excalidraw-mcp-app.mcpb из Releases.
2. Дважды кликните — установится в Claude Desktop.

Вариант B: Сборка из исходников

git clone https://github.com/excalidraw/excalidraw-mcp.git
cd excalidraw-mcp-app
pnpm install && pnpm run build

После сборки добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": ["/path/to/excalidraw-mcp-app/dist/index.js", "--stdio"]
    }
  }
}

Перезапустите Claude Desktop.

Использование

Примеры запросов:

• «Нарисуй милого кота с помощью excalidraw»
• «Нарисуй диаграмму архитектуры: пользователь подключается к API-серверу, который общается с базой данных»

Сервер возвращает интерактивный HTML — диаграмму, которую можно редактировать в полный экран.

Для разработчиков: что такое MCP Apps и как создать свою

MCP Apps — официальное расширение Model Context Protocol, позволяющее серверам возвращать интерактивные HTML-интерфейсы (графики, формы, дашборды), которые рендерятся прямо в чате.

• Документация для людей
• Гайд для AI (skill)

Развёртывание собственного экземпляра

1. Сделайте fork репозитория.
2. Откройте Vercel и импортируйте fork.
3. Никаких переменных окружения не нужно — просто деплой.
4. Сервер будет доступен по адресу https://your-project.vercel.app/mcp.

Внесение изменений

Pull Request приветствуются. Инструкция по сборке — в разделе «Локальная установка».

Релизный чек-лист (для мейнтейнеров)

1. Обновить версию в manifest.json и package.json.
2. Собрать и запаковать:

   pnpm run build && mcpb pack .
   

3. Создать GitHub release:

   gh release create v0.3.0 excalidraw-mcp-app.mcpb --title "v0.3.0" --notes "Что изменилось"
   

4. Задеплоить на Vercel:

   vercel --prod
   

Благодарности

Создано на основе Excalidraw — виртуальной доски для рисования диаграмм от руки.

Лицензия

MIT