✦ OpenBoard
Local-first personal whiteboard workspace for developers and external AI agents.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
# Launch directly without installing:
npx openboard-app start
# Or install globally:
npm install -g openboard-app
openboard start
All whiteboards, documents, and canvas metadata reside locally in your SQLite database:
~/.openboard/openboard.db
OpenBoard is a modern, lightweight, local-first infinite whiteboard pairing an interactive tldraw canvas with a high-performance Model Context Protocol (MCP) server.
It is designed for developers who want a fast personal whiteboard and for autonomous AI coding agents (Claude Code, Cursor, OpenCode, OpenAI Codex, OpenClaw, Hermes) to inspect, create, organize, and update software architecture diagrams, system topologies, database schemas, and workflows collaboratively.
┌───────────────────────────────────────────────────────────┐
│ EXTERNAL AI AGENT │
│ (Claude Code, Cursor, OpenCode, Codex, Hermes...) │
└─────────────────────────────┬─────────────────────────────┘
│ JSON-RPC 2.0 (stdio / SSE)
▼
┌───────────────────────────────────────────────────────────┐
│ OPENBOARD MCP SERVER │
│ (13 High-Level Semantic Tools) │
└──────────────┬─────────────────────────────┬──────────────┘
│ │
▼ ▼
┌───────────────────────────┐ ┌─────────────────────────────┐
│ LOCAL SQLITE DATABASE │ │ HEADLESS CANVAS ENGINE │
│ (~/.openboard/openboard.db│ │ (tldraw store + SVG vector)│
└───────────────────────────┘ └──────────────┬──────────────┘
│
▼ SSE Live Sync
┌─────────────────────────────┐
│ BROWSER WHITEBOARD │
│ (http://localhost:4747) │
└─────────────────────────────┘
~/.openboard/openboard.db).#0e0e11), electric blue accents (#2563eb), zero-dependency SVG iconography, and responsive design.N for new whiteboards, / to focus search, Esc to dismiss dialogs, and Enter to confirm.npx (No installation required)npx openboard-app start
npmnpm install -g openboard-app
openboard start
openboard mcp
OpenBoard provides a universal Model Context Protocol server over stdio (and HTTP/SSE at http://localhost:4747/api/mcp).
Add this to your MCP configuration file:
{
"mcpServers": {
"openboard": {
"command": "openboard",
"args": ["mcp"]
}
}
}
OpenBoard equips AI agents with 13 semantic tools structured for developer tasks:
list_boards: Search and filter whiteboards (all, recent, favorites, trash).create_board: Create a new whiteboard with title and optional description.get_board: Retrieve board metadata, document summary, and timestamps.rename_board: Rename an existing whiteboard.duplicate_board: Clone a board and its complete canvas document.favorite_board: Bookmark or toggle favorite status.delete_board: Move a whiteboard to Trash (soft delete).restore_board: Recover a deleted whiteboard from Trash.get_canvas_state: Retrieve structured shapes, bounds, text, and arrow bindings.get_canvas_screenshot: Render a headless vector SVG visual screenshot.create_shapes: Create shapes (rectangles, ellipses, notes, text, frames, arrows).update_shapes: Modify positions, dimensions, text, colors, or arrow bindings.delete_shapes: Remove shapes and automatically clean up associated connections.BoardService and CanvasService.board_id targeting: Every canvas operation explicitly references the target board ID.openboard/
├── apps/
│ ├── web/ # React 18 + Vite frontend (tldraw canvas, Twenty dark UI, Docs)
│ └── server/ # Express + SQLite API server + SSE live projection
├── packages/
│ ├── shared/ # TypeScript interfaces, DTOs, schemas & shape contracts
│ ├── storage/ # SQLiteBoardRepository with ACID migrations & memory fallback
│ ├── core/ # BoardService, CanvasService, HeadlessSvgRenderer
│ └── mcp/ # OpenBoardMcpServer (stdio / SSE JSON-RPC 2.0 transport)
├── cli/ # openboard-app CLI binary with embedded web assets
├── docs/ # Architectural guides & AI agent integration tutorials
└── .github/ # CI workflows and issue / PR templates
openboard start # Start local workspace server & open web dashboard (default port: 4747)
openboard mcp # Start Model Context Protocol server on stdio for AI agents
openboard info # Display local configuration, database path, and agent MCP details
openboard -v # Display installed version
openboard --help # Display CLI help
openboard start-p, --port <number>: Port to listen on (default: 4747)-h, --host <host>: Host address to bind to (default: localhost)--db <path>: Custom SQLite database path (default: ~/.openboard/openboard.db)--no-open: Do not automatically open browser on startupContributions are warmly welcome! Whether you are reporting an issue, proposing an MCP feature, or improving developer documentation:
# Clone the repository
git clone https://github.com/atpaawej/openboard.git
cd openboard
# Install dependencies & build
npm install
npm run typecheck
npm run test
npm run build
OpenBoard is open-source software licensed under the MIT License.
Copyright © 2026 OpenBoard Contributors.
Local-first personal whiteboard workspace for developers and external AI agents (tldraw + MCP stdio/SSE + SQLite)
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Openboard 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 Local-first personal whiteboard workspace for developers and external AI agents (tldraw + MCP stdio/SSE + SQLite)