whiteboard-mcp 0.2.0

A web-based whiteboard service

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.

Install

From PYPI

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

From source

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

The server listens on 0.0.0.0:5000 by default.

Web UI language

The web UI supports English (en) and Chinese (zh).

• Config file: ~/.whiteboard-mcp/config.yaml
• Key: language, value en or zh

If language is not set in that file (or the file is missing), the UI language follows the browser Accept-Language header: Chinese (zh, zh-CN, etc.) maps to Chinese; anything else defaults to English.

Example:

language: zh

You can edit this file by hand, or use More (⋯) → Settings in the web UI, choose a language, and click Save (the server writes the same file and reloads the page).

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 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).

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"
            ]
        }
    }
}