Web Whiteboard

Um Quadro Branco Baseado na Web com Interface MCP

whiteboard-mcp é um aplicativo web simples de quadro branco, fornecendo uma maneira conveniente de exibir a saída de Chatbots/LLMs.

Recursos

• Quadro branco web — Interface de navegador para mostrar conteúdo enviado por agentes ou outros clientes; ótimo para demonstrações e exibição lado a lado de saídas de LLM.
• Qualquer tela — Abra a URL do quadro em um navegador em qualquer monitor, projetor ou dispositivo na sua rede.
• Transportes MCP duplos — Streamable HTTP em /mcp e SSE em /sse para clientes que suportam apenas um estilo.
• API REST — GET/POST /api/content para integrações não-MCP; histórico de listagem/restauração/exclusão em /api/history.
• Histórico — Histórico no servidor de atualizações; reabra uma versão anterior pela interface de histórico (e pela API de histórico).
• Exportação — Salve a visualização atual como HTML ou Markdown pelo menu; Imprimir / PDF (impressão do navegador para PDF) quando o quadro exibe HTML ou Markdown.
• Interface bilíngue — Interface em inglês e chinês, configurações em arquivo ou no aplicativo.

Instalação

A partir do PYPI

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

A partir do código-fonte

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

O servidor escuta em 0.0.0.0:5000 por padrão.

Endpoints MCP

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

Use o IP LAN da sua máquina em vez de 127.0.0.1 ao conectar de outro dispositivo na mesma rede.

Ferramentas MCP

O servidor MCP expõe estas ferramentas (nomes conforme registrados nos clientes):

Ferramenta	Finalidade
update_whiteboard_url	Define o quadro para carregar uma URL (url).
update_whiteboard_html	Renderiza HTML bruto (html).
update_whiteboard_markdown	Renderiza Markdown (markdown).

Configuração MCP

API padrão /mcp

Clientes que suportam Streamable HTTP nativamente devem apontar a URL do servidor MCP para http://127.0.0.1:5000/mcp (ajuste host/porta para LAN conforme necessário).

Hermes-Agent configuração MCP exemplo:

Adicione uma entrada de transporte HTTP em mcp_servers em ~/.hermes/config.yaml, depois reinicie o Hermes. Exemplo:

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

API compatível /sse

Por exemplo, você pode usar mcp-remote para conectar à API /sse:

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