tl-draw-mcp
tl-draw-mcp
MCP-Server + Claude Code-Skill, mit dem Claude basierend auf Prompts auf einer Live-tldraw-Leinwand zeichnen kann.
Öffnen Sie
http://localhost:3030in einem beliebigen Browser → Claudes Zeichnungen erscheinen in Echtzeit.Vier Werkzeuge:
create_shape,update_shape,delete_shape,get_canvas.Reines JS, MIT-Lizenz, Windows-fokussiert.
1. Installation
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. In Claude Code einbinden
Einzeiler (empfohlen — keine JSON-Bearbeitung erforderlich):
claude mcp add tldraw --scope user -- cmd /c node "D:/path/to/tl-draw-mcp/packages/server/dist/index.js"Überprüfung:
claude mcp listSie sollten tldraw in der Liste sehen. Starten Sie Claude Code neu.
3. Skill installieren
Kopieren Sie den Skill-Ordner, damit Claude weiß, wann er zeichnen soll:
xcopy /E /I .claude\skills\tldraw %USERPROFILE%\.claude\skills\tldraw4. Verwendung
Starten Sie Claude Code in einem beliebigen Projekt.
Der erste Werkzeugaufruf startet den Server — öffnen Sie
http://localhost:3030.Das Badge unten rechts zeigt
tldraw MCP · connectedan.Prompt:
Zeichne ein Flussdiagramm eines Login-Ablaufs.
5. Entwicklung
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. Layout
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. Fehlerbehebung
Symptom | Lösung |
Badge zeigt | Veralteter Server auf :3030. |
Tldraw-Validierungsfehler im Browser | IndexedDB leeren (F12 → Anwendung → IndexedDB → |
Port :3030 belegt | Server weicht automatisch auf :3031 usw. aus. Überprüfen Sie die MCP-Protokolle über |
| Erneut versuchen mit |
Siehe plan.md für Design-Notizen und LICENSE für die MIT-Bedingungen.
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-