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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Online whiteboard your AI agent draws on: live shared canvases, solo or with your team.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.66 npm3MIT
- AlicenseAqualityDmaintenanceEnables 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.11101MIT
- 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.MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to create, open, and edit persistent tldraw whiteboards in real-time, with live collaboration between human and AI.1-