Web Whiteboard

Un pizarrón web con interfaz MCP

whiteboard-mcp es una aplicación web simple de pizarrón, que proporciona una forma conveniente de mostrar la salida de Chatbots/LLMs.

Características

• Pizarrón web — Interfaz de navegador para mostrar contenido enviado por agentes u otros clientes; ideal para demostraciones y comparación de salidas de LLMs lado a lado.
• Cualquier pantalla — Abre la URL del pizarrón en un navegador en cualquier monitor, proyector o dispositivo en tu red.
• Doble transporte MCP — Streamable HTTP en /mcp y SSE en /sse para clientes que solo soportan un estilo.
• API REST — GET/POST /api/content para integraciones que no usan MCP; historial de lista/restaurar/eliminar bajo /api/history.
• Historial — Historial en el servidor de actualizaciones; reabre una versión anterior desde la interfaz de historial (y mediante la API de historial).
• Exportar — Guarda la vista actual como HTML o Markdown desde el menú; Imprimir / PDF (impresión del navegador a PDF) cuando el pizarrón muestra HTML o Markdown.
• Interfaz bilingüe — Interfaz en inglés y chino, mediante archivo o configuración dentro de la aplicación.

Instalación

Desde PYPI

pip install whiteboard-mcp
# or:
# uv tool install whiteboard-mcp
whiteboard-mcp

Desde el código fuente

git clone .../whiteboard-mcp
cd whiteboard-mcp
uv run whiteboard_mcp

El servidor escucha en 0.0.0.0:5000 por defecto.

Endpoints MCP

Transporte	URL (local)
StreamableHTTP	http://127.0.0.1:5000/mcp (POST /mcp)
SSE (+ mensajes)	http://127.0.0.1:5000/sse (+ POST /sse/messages/)

Usa la IP LAN de tu máquina en lugar de 127.0.0.1 al conectarte desde otro dispositivo en la misma red.

Herramientas MCP

El servidor MCP expone estas herramientas (nombres tal como se registran ante los clientes):

Herramienta	Propósito
update_whiteboard_url	Configura el pizarrón para cargar una URL (url).
update_whiteboard_html	Renderiza HTML sin procesar (html).
update_whiteboard_markdown	Renderiza Markdown (markdown).

Configuración de MCP

API estándar /mcp

Los clientes que soportan Streamable HTTP de forma nativa deben apuntar su URL de servidor MCP a http://127.0.0.1:5000/mcp (ajusta host/puerto según sea necesario para LAN).

Hermes-Agent Configuración de MCP ejemplo:

Agrega una entrada de transporte HTTP bajo mcp_servers en ~/.hermes/config.yaml, luego reinicia Hermes. Ejemplo:

mcp_servers:
  whiteboard:
    url: "http://127.0.0.1:5000/mcp"

API compatible /sse

Por ejemplo, puedes usar mcp-remote para conectarte a la API /sse:

{
    "mcpServers": {
        "whiteboard-mcp": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://127.0.0.1:5000/sse",
                "--allow-http"
            ]
        }
    }
}