Skip to main content
Glama

tl-draw-mcp

MCP-сервер + навык для Claude Code, позволяющий Claude рисовать на интерактивном холсте tldraw по текстовым запросам.

  • Откройте http://localhost:3030 в любом браузере — рисунки Claude появятся в режиме реального времени.

  • Четыре инструмента: create_shape, update_shape, delete_shape, get_canvas.

  • Чистый JS, лицензия MIT, приоритет для Windows.


1. Установка

git clone <this repo> tl-draw-mcp
cd tl-draw-mcp
npm install
cd packages\web    && npm run build
cd ..\server       && npm run build

Related MCP server: Excalidraw MCP Server

2. Подключение к Claude Code

Одной командой (рекомендуется — без редактирования JSON):

claude mcp add tldraw --scope user -- cmd /c node "D:/path/to/tl-draw-mcp/packages/server/dist/index.js"

Проверка:

claude mcp list

Вы должны увидеть tldraw в списке. Перезапустите Claude Code.


3. Установка навыка

Скопируйте папку навыка, чтобы Claude знал, когда нужно рисовать:

xcopy /E /I .claude\skills\tldraw %USERPROFILE%\.claude\skills\tldraw

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

  1. Запустите Claude Code в любом проекте.

  2. Первый вызов инструмента запустит сервер — откройте http://localhost:3030.

  3. Значок в правом нижнем углу покажет tldraw MCP · connected.

  4. Запрос:

    Нарисуй блок-схему процесса входа в систему.


5. Разработка

cd packages\server && npm test           :: 12 handler tests
cd packages\server && npm run dev        :: stdio + WS bridge on :3030
cd packages\web    && npm run dev        :: Vite HMR on :5173

6. Макет

packages/server   MCP stdio server, WS bridge, static host, tool handlers
packages/web      Vite + React + tldraw browser app (builds into server/public)
.claude/skills/   SKILL.md for Claude Code
examples/         sample MCP config (if you prefer JSON over the CLI)

7. Устранение неполадок

Симптом

Решение

Значок показывает connected, но Claude пишет "no browser"

Устаревший сервер на :3030. taskkill /F /IM node.exe, закройте вкладки, перезапустите Claude Code.

Ошибка валидации Tldraw в браузере

Очистите IndexedDB (F12 → Application → IndexedDB → удалить TLDRAW_*), выполните жесткую перезагрузку.

Порт :3030 занят

Сервер автоматически переключится на :3031 и т.д. Проверьте логи MCP через /mcp, чтобы узнать реальный URL.

Ошибка npm install peer-dep

Повторите с npm install --legacy-peer-deps.


См. plan.md для заметок по проектированию и LICENSE для условий MIT.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to read, write, and search local tldraw (.tldr) files, providing a persistent visual scratchpad for diagramming and note organization. It supports full CRUD operations on canvas shapes and metadata management for local canvas files.
    23 npm
    3
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas through element-level CRUD operations and real-time synchronization. It allows agents to iteratively build, inspect, and refine diagrams while providing visual feedback via screenshots and scene descriptions.
    4,412 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas with element-level CRUD operations and real-time synchronization. It supports iterative diagramming through scene descriptions, screenshots, and advanced layout tools for collaborative AI-human workflows.
    4,412 npm
    2
    MIT