Excaliself MCP
Excaliself — свой сервер доски Excalidraw: встроенный MCP дает агенту искать, читать, создавать и экспортировать схемы.
- 153 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен действует от вашего имени: агент видит схемы и может отправить их в корзину.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/excaliselfОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен действует от вашего имени: агент видит схемы и может отправить их в корзину.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Excaliself — небольшое приложение с редактором Excalidraw, совместной работой в реальном времени, командным пространством, папками и поиском. Все схемы лежат в вашем Postgres. В приложение встроен MCP-сервер на адресе `/api/mcp`, ключ LLM на сервере не нужен. Агент находит и читает схему: фигуры, текст и связи стрелок. Он создает новую по простым фигурам или по блок-схеме Mermaid, выгружает PNG, SVG или файл `.excalidraw`, создает папки и переносит схемы. Правки агент готовит как черновик: на холсте они ждут вашей кнопки «Применить», после чего их видят все участники.
Для кого. Командам, которые держат схемы архитектуры и доски на своем сервере и хотят, чтобы агент рисовал и находил их.
Подходит, если
- Агент по описанию системы рисует схему и кладет ее в папку команды.
- Нужно найти старый чертеж по тексту внутри схем.
- В документацию попадает экспорт схемы в SVG со встроенными шрифтами.
- Агент готовит правку схемы, а автор принимает ее одним нажатием.
Не подходит, если
- Нужна облачная доска без администрирования сервера.
- Схемы нельзя открывать агенту ни в каком виде.
- Требуется, чтобы агент менял холст без подтверждения.
Пример запроса к агенту
Нарисуй схему сервисов проекта в виде блок-схемы Mermaid и положи ее в папку Team.MCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
POSTGRES_PASSWORDобязательная, секрет- Пароль базы данных приложения, задается в `.env`.
BETTER_AUTH_SECRETобязательная, секрет- Секрет сессий приложения, задается в `.env`.
BASE_URLобязательная- Публичный адрес экземпляра.
Ограничения
Нужно развернуть приложение с Postgres: по Docker Compose, Coolify или Railway. Для входа через Claude.ai экземпляр должен быть доступен из интернета по HTTPS. Остальные клиенты подключаются с токеном из раздела «Настройки, MCP», токен виден один раз. Claude Desktop работает через `mcp-remote` и требует Node. Токен действует от вашего имени: агент увидит ваши схемы и сможет отправить их в корзину, где они хранятся 30 дней.
Как отключить. Отзовите токен или отключите приложение в «Настройки, MCP». Удалите запись `excaliself` из конфигурации клиента.
Частые вопросы
Как подключить Excaliself к Claude Code?
Создайте токен в «Настройки, MCP» и выполните `claude mcp add --transport http excaliself https://draw.example.com/api/mcp --header "Authorization: Bearer exs_..."`. Диалог токена показывает готовую команду.
Может ли агент испортить схему?
Нет без вашего ведома: правки `edit_drawing` ждут кнопки «Применить» на холсте. Удаление идет в корзину на 30 дней, окончательно агент ничего не стирает.
Нужен ли ключ OpenAI или Anthropic на сервере?
Нет. Модель приносит клиент, а сам экземпляр ключа LLM не требует.
Как быстро попробовать Excaliself?
Выполните `docker run --rm -p 127.0.0.1:3000:3000 -e PREVIEW_MODE=true ghcr.io/maciekzygmunt/excaliself` и откройте `/preview/login`. Данные хранятся в памяти и пропадут при остановке.
В каких форматах агент экспортирует схему?
В PNG или SVG через `export_drawing`, а `export_scene` отдает файл `.excalidraw`. В SVG встроены шрифты схемы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыExcalidraw MCP
Excalidraw MCP App Server
MCP-сервер рисует диаграммы в стиле от руки Excalidraw прямо в чате: потоковая отрисовка, полноэкранное редактирование, экспорт
Скилл и локальный сервер: Claude Code рисует блок-схемы и архитектуру, а диаграммы растут на холсте Excalidraw в браузере.
Официальные плагины, скиллы и MCP от Miro: агент читает доски, рисует диаграммы, ведет таблицы и пишет код по макетам
PenEcho, холст для рукописных заметок и диаграмм, подключается к Claude Code и Codex через MCP рядом с рабочим окном.
Подключает агента к Nextcloud: заметки, календарь, контакты, файлы, почта и доски Deck через 110 с лишним инструментов MCP
MCP-эндпоинт рабочего пространства Salt на вашем сервере: агент создает страницы и базы, ищет и комментирует с правами человека.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Excaliself (эта карточка) | да | OAuth | 153 | |
| Excalidraw MCP | да | не нужна | 5 667 | MCP-приложение для Excalidraw без хранилища; Excaliself хранит схемы в Postgres и ведет учетные записи |
| Excalidraw MCP Server | нет | не нужна | 2 646 | набор MCP, CLI и скилла вокруг Excalidraw; Excaliself развертывается как командный сервер |
Коротко о README
Excaliself — полноценное приложение на TanStack Start с Better Auth, Postgres и Drizzle, лицензия MIT. MCP описан отдельным разделом README, там же список инструментов.