tl-draw-mcp
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 buildRelated 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\tldraw4. Использование
Запустите Claude Code в любом проекте.
Первый вызов инструмента запустит сервер — откройте
http://localhost:3030.Значок в правом нижнем углу покажет
tldraw MCP · connected.Запрос:
Нарисуй блок-схему процесса входа в систему.
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 :51736. Макет
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. Устранение неполадок
Симптом | Решение |
Значок показывает | Устаревший сервер на :3030. |
Ошибка валидации Tldraw в браузере | Очистите IndexedDB (F12 → Application → IndexedDB → удалить |
Порт :3030 занят | Сервер автоматически переключится на :3031 и т.д. Проверьте логи MCP через |
Ошибка | Повторите с |
См. plan.md для заметок по проектированию и LICENSE для условий MIT.
This server cannot be deployed
Maintenance
Related MCP Connectors
Whiteboard where any shape opens into another canvas. Claude Code and Codex plugins render plans on it.
Give Claude a whiteboard: notes, links, images and diagrams on a board you both see and edit.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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 npm3MIT
- AlicenseAqualityCmaintenanceEnables AI agents to programmatically generate, edit, and view Excalidraw diagrams with real-time browser synchronization. It provides a suite of tools for adding shapes, text, and arrows to diagrams through natural language interactions.114,221 npm101MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm2MIT