convez.ai
MCP ServerDesign & UIIntermediário
kennycornellius-collab

Sketchpad MCP

kennycornellius-collab/sketchpad-mcp

Esboce e envie imagens para agentes de IA processar visualmente

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta de entrada visual que permite desenhar ideias em um canvas Excalidraw e enviar diretamente para agentes de IA. Inverte o fluxo comum: ao invés do agente gerar diagramas, você esboça e o agente processa a imagem. Integra-se nativamente ao Claude Code.

Instalação

$npx convez-ai kennycornellius-collab/sketchpad-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Comunicar layouts e wireframes visuais para o agente implementar
  • Iterar designs e diagramas arquiteturais em tempo real
  • Converter esboços manuais em código ou descrições estruturadas

Veredito

Solução prática que inverte o padrão MCP usual — permite que você sketch visualmente e o agente processe. Bem integrada ao Claude Code, com canvas persistente para iterações. Categoria Design & UI pela natureza visual, embora tenha forte aplicação em desenvolvimento.

README

A tradução para o português deste README ainda está na fila.

sketchpad-mcp

CI PyPI

A visual input tool for AI coding agents. You sketch; the agent reads the sketch.

Most MCP drawing tools go agent → human (the agent generates a diagram for you to view). This one goes the other way: human → agent. Open a canvas, draw your idea, and the resulting image lands directly in the agent's context.


How it works

  1. The agent calls open_canvas (or you ask it to: "open the canvas, I want to sketch this")
  2. A drawing tab opens in your default browser — powered by Excalidraw
  3. You sketch, paste, or annotate
  4. Click Send to Claude — the PNG is returned directly to the agent
  5. The tab stays open; the agent can call the tool again and your drawing is still there to refine

Requirements

  • Python 3.10+
  • Claude Code (CLI)

Installation

Easiest — with uv (no install step at all):

claude mcp add sketchpad --transport stdio --scope user -- uvx sketchpad-mcp

uvx fetches the package from PyPI on first run and keeps it cached.

Or with pip:

pip install sketchpad-mcp
claude mcp add sketchpad --transport stdio --scope user -- sketchpad-mcp

If sketchpad-mcp isn't on your PATH (e.g. installed inside a venv), register the absolute path to the executable, or use python -m sketchpad_mcp with that environment's python.

Verify it's registered:

claude mcp list

You should see sketchpad in the list.

From source (for development):

git clone https://github.com/kennycornellius-collab/sketchpad-mcp.git
cd sketchpad-mcp
pip install -e ".[dev]"
pytest  # run the test suite

Usage

Once registered, the tools are available in any Claude Code session.

Let the agent decide — Claude Code will open the canvas on its own when your description is ambiguous or visual.

Ask explicitly:

"Open the canvas, I want to sketch the layout."

"Draw me a rough wireframe and send it over."

The canvas tab stays alive across calls in the same session — you can refine the same drawing across multiple back-and-forths without losing your work.


Tools

open_canvas

Opens the Excalidraw canvas and returns the sketch as a PNG image directly into the agent's context.

Use this when the agent can accept images (Claude Code always can).

Optional parameter: hint — a short reminder shown above the canvas (e.g. "Sketch the dashboard layout").

describe_sketch

Same canvas flow, but returns the PNG plus a prompt asking the agent to describe what you drew — the description is produced by the agent's own vision, no extra API key needed.

Use this when you want a reusable text representation of the sketch alongside the image — useful for saving the description to a file or passing it to a non-vision step later. Requires a vision-capable agent (Claude Code always is).


Canvas controls

The canvas is a full Excalidraw instance — shapes, arrows, text, freehand, colors, undo/redo all work. A few things specific to sketchpad-mcp:

  • Send to Claude — submits the current canvas state as a PNG
  • Close tab — closes the browser tab when you're done with the session. If the agent is waiting on a sketch, closing the tab (button or browser X) tells it immediately that you've declined, instead of leaving it waiting for the timeout

License

MIT. See LICENSE.

Built with assistance from Claude Code. Excalidraw embedded via CDN under its MIT license.


Other clients

sketchpad-mcp uses standard MCP stdio transport, so it should work with Cursor, Zed, Claude Desktop, and any other MCP-compatible coding agent. If you try it on one of those and want to help document the setup, feel free to open an issue or reach out — happy to add verified setup snippets for other clients.

Ver o original no GitHub

Bom para

Relacionados