
Web Whiteboard
โ 2from mikewei
A web-based whiteboard for displaying output from Chatbots and LLMs.
A Web-based Whiteboard with MCP interface
whiteboard-mcp is a simple whiteboard web application, providing a convenient way for displaying Chatbot/LLM's output.
Features
- Web whiteboard โ Browser UI to show content pushed by agents or other clients; good for demos and side-by-side LLM output.
- Any screen โ Open the board URL in a browser on any monitor, projector, or device on your network.
- Dual MCP transports โ Streamable HTTP at
/mcpand SSE at/ssefor clients that only support one style. - REST API โ
GET/POST /api/contentfor non-MCP integrations; history list/restore/delete under/api/history. - History โ Server-side history of updates; reopen a past version from the history UI (and via the history API).
- Export โ Save the current view as HTML or Markdown from the menu; Print / PDF (browser print-to-PDF) when the board shows HTML or Markdown.
- Bilingual UI โ English and Chinese interface, file or in-app settings.
MCP endpoints
| Transport | URL (local) |
|---|---|
| StreamableHTTP | http://127.0.0.1:5000/mcp (POST /mcp) |
| SSE (+ messages) | http://127.0.0.1:5000/sse (+ POST /sse/messages/) |
Use your machine's LAN IP instead of 127.0.0.1 when connecting from another device on the same network.
MCP tools
The MCP server exposes these tools (names as registered with clients):
| Tool | Purpose |
|---|---|
update_whiteboard_url | Set the board to load a URL (url). |
update_whiteboard_html | Render raw HTML (html). |
update_whiteboard_markdown | Render Markdown (markdown). |
MCP configure
Standard /mcp API
Clients that support Streamable HTTP natively should point their MCP server URL at http://127.0.0.1:5000/mcp (adjust host/port for LAN as needed).
Hermes-Agent MCP config example:
Add an HTTP transport entry under mcp_servers in ~/.hermes/config.yaml, then restart Hermes. Example:
mcp_servers:
whiteboard:
url: "http://127.0.0.1:5000/mcp"Compatible /sse API
For example you can use mcp-remote to connect /sse API:
{
"mcpServers": {
"whiteboard-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"http://127.0.0.1:5000/sse",
"--allow-http"
]
}
}
}pip install whiteboard-mcp
# or:
# uv tool install whiteboard-mcp
whiteboard-mcpInstall
From PYPI
pip install whiteboard-mcp
# or:
# uv tool install whiteboard-mcp
whiteboard-mcpFrom source
git clone .../whiteboard-mcp
cd whiteboard-mcp
uv run whiteboard_mcpThe server listens on 0.0.0.0:5000 by default.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ