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