This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
一张本地优先的双向画板：人和 AI 都能在上面画图表达意思，并读取对方留下的视觉上下文。
Doodle 只有一个内核：人和 AI 共用的无限画板。AI 通过 MCP 工具在 Agent 内画，人直接在画布上画；任何一方都能接着改，画板本身就是沟通媒介。对话仍留在宿主聊天里，Doodle 不创建第二套会话。
对外只有两个入口：
Codex 插件：推荐安装方式，一条命令完成安装。
直接 MCP / npx：任意 MCP 宿主都可使用，无需 clone 仓库。
宿主能力分三层：四工具始终可用；支持 MCP Apps 时把同一张画布显示在对话旁；支持 updateModelContext / sendMessage 时增加自动同步和短通知。宿主不渲染画布时，get_board 返回的 PANEL_URL 是本地兜底页面。项目结构只是可选素材，不是产品主体。
画板图库保存的是可编辑的版本 1 画板快照：可以另存当前图、切换不同图、新建 / 重命名 / 复制 / 删除图，以及导入 / 导出 JSON。它不是静态 PNG 导出，也不是第二套会话模型；get_board、MCP App 和本地画布始终读写同一张当前活动图。
PANEL_URL 属于当前 MCP server 进程：会话或宿主退出后它会失效，这是正常生命周期。需要脱离会话、手动开关的本地预览时，运行 npm run preview:board；它只启动画板 HTTP 服务，不注册 MCP stdio 工具，也不会安装后台服务。用 Ctrl+C 停止。
双向主流程：
AI 用 draw_board 画 → 人看后直接画 / 改 → 最终状态进入当前会话上下文 / 人点通知
→ AI 用 get_board 或上下文读取 → AI 继续画 / 改 → 人再看……可无限往返产品定义见 docs/PRODUCT_DIRECTION.md，plugin 目标见 docs/GOAL_PLUGIN.md，架构见 docs/ARCHITECTURE.md，AI 操作手册见 AGENTS.md。
Related MCP server: Lousa
选一个入口：
Codex 桌面插件：在 Doodle 仓库里运行一条命令：
npm run setup:codex它会自动安装依赖、构建自包含插件、注册本仓库的本地 marketplace、安装 doodle@doodle，并打印首句提示。开启一个新的 Codex 会话，然后说：
打开 Doodle 画板，我们先用画板交流。兼容 MCP Apps 的宿主会直接显示画布；AI 会先读画板，再放一个起步对象。你可以选工具点按 / 拖拽直接画，画笔按下即出墨并可连续画，橡皮擦只擦画笔笔迹；双击对象改字、双击空白新建便签；空白处拖拽可框选并批量移动 / 删除 / 成组 / 整理，支持 Ctrl/⌘+Z 撤销重做、方向键微调、对齐吸附和 Ctrl/⌘+V 粘贴图片。右上角「图库」可保存当前图、切换不同图，以及导入 / 导出可编辑 JSON。? 可随时查看提示。人画完后，宿主会自动同步最终状态（若支持），也可点「通知 Agent」发一句短提醒；AI 会看画、用文字或继续画图回应。若宿主不显示画布，就问 AI 要 PANEL_URL，打开本地地址，并在聊天里让 AI 重读。
完整链路：npm run setup:codex → 新会话 → 首句提示 → AI 和人双向画 / 改 → 最终状态同步 / 通知 Agent → AI 再看 / 再画。
任意 MCP 宿主：把 examples/mcp-config/ 的 npx -y doodle-mcp 片段加入宿主配置，重启 MCP 会话后使用同一句提示；画布仍通过 show_board / draw_board 自动呈现，宿主不渲染时询问 PANEL_URL。这条路径不需要 clone 仓库，也不等于公共插件目录发布。
工具 | 用途 |
| 读取共享画布；空画板给 |
| 在 Agent 对话旁打开可交互的共享画布；用户要求查看或编辑画布时使用 |
| 新增对象、精确更新、删除、确定性布局、连接线、变体 / 角色 / 样式 / 层级，以及通过 |
| 可选只读扫描当前项目结构，返回有界相对路径和 |
默认双向闭环：
AI: get_board → draw_board → 看人怎么改
人: 看画 → 直接画 / 改 → 自动同步或通知 Agent
然后重复；对话始终留在宿主聊天里show_board 只是在兼容宿主里显示这张画布的可选工具；scan_project 只是「项目结构」这个主题的能力之一。AI 决定是否需要，并用 draw_board 把结果画到同一张画布；它们不创建图库、不改会话、不授权代码变更。
一条命令即可完成安装，详见上方「30 秒上手」：
npm run setup:codexscripts/setup-codex.mjs 只会在你主动运行时调用 Codex CLI：npm install（首次）、npm run build、codex plugin marketplace add . --json、codex plugin add doodle@doodle --json。重复运行是安全的；可用 npm run setup:codex -- --dry-run 预览命令。官方 OpenAI 文档说明本地 marketplace 与公共插件目录是不同路径，安装后应开启新会话再使用插件的 MCP 工具和 skill。插件包由 scripts/build-plugin.mjs 生成到忽略的 .doodle-plugin/doodle/，使用同一个自包含 stdio MCP server，不依赖仓库里的 dist/ 或绝对路径。npm run build:submission 会生成忽略的 doodle-plugin-submission/doodle-0.7.0.zip 供提交审核；本仓库提供本地 / repo marketplace 安装路径，公共插件目录发布仍需要 OpenAI 侧资格、身份验证和审核。材料清单见 docs/SUBMISSION.md。
把 examples/mcp-config/ 的零配置片段加入 MCP 宿主即可；发布版使用 npx -y doodle-mcp，无需绝对路径。本地 checkout 也可使用 node dist/index.js（先运行 npm run build）。默认自动选择空闲本地端口、隔离画板状态目录，并通过启动环境推断工作区；只有宿主在项目外启动 MCP 时才需要设置 DOODLE_WORKSPACE_ROOT。可选环境变量：
变量 | 默认值 | 说明 |
| 空闲端口 | 固定本地画板 HTTP 端口；未设置或设为 |
|
| 本地监听地址 |
| plugin data / | 画板状态目录 |
| 包根目录 |
|
|
| stderr 日志级别 |
npm install
npm run check
npm run doctor
npm run preview:board状态文件位于所选目录下的 .doodle/board.json，是独立 version 1 状态，应加入忽略，不提交到仓库。既有 version 1 留言字段为兼容旧状态而保留；新画布和 Agent 工具不再显示或写入留言流。
AI_DRAW_WORKSPACE_ROOT 和旧的 output/.ai-draw/board.json 仍作为只读兼容入口保留；新配置请使用 DOODLE_WORKSPACE_ROOT。
先调用 get_board 读取现有对象 ID 和坐标。
尽量用 draw_board.updates 精确修改；确需重画时再用 remove_ids 清理旧对象。
author 放在 draw_board 顶层参数，不放进 item。
line 可用 shape: "straight" | "curve" | "orthogonal"；stroke 的 points 是相对对象边界的局部坐标；image 使用有界的 data:image/*;base64。
先读 capabilities、visualDigest 和 RECIPES：流程用 role: "step" + startItemId / endItemId，对比用 role: "column" 或 variant: "frame"，聚类用 groupId + layout.mode: "cluster"，重点用 emphasis: "focus"。
可选 variant / role / z / style / startItemId / endItemId 都是版本 1 兼容字段；layout.mode 支持 grid / row / column / timeline / cluster。
draw_board.library 支持 list / get / create / save / switch / rename / duplicate / delete / import / export；切换后会改变当前活动画板，get_board 随后读到的就是新图。
图库文件保存在本地 OUTPUT_DIR/.doodle/boards/，每个图都是完整的版本 1 board.json 结构，不生成静态图片。
结构化图用严格网格、短标签、一致尺寸。
line 是箭头：(x,y) 为起点，(x+w,y+h) 为终点；w / h 可为负数。
箭头端点贴着源对象和目标对象的外缘，标签保持短。
工具调用不主动打开浏览器，画布对象不构成项目写入授权。
stdout 只用于 MCP JSON-RPC；所有日志写 stderr。
本地 HTTP 默认只监听 127.0.0.1。
非 GET /api/board/* 需要页面随机 X-AI-Draw-Token、confirmedBy: "human" 和匹配的画板 revision。
scan_project 跳过常见生成目录、dot-private 文件、.env-like 文件和大文件，过滤常见凭据行，证据总数最多 40 条；只返回工作区相对路径与短证据。
画布对象只是视觉上下文，不签发凭据，不写项目文件。嵌入 UI 通过 MCP Apps 宿主桥调用正常画布工具。
支持上下文能力的嵌入 UI 还会把当前画板最终状态挂到宿主当前会话的模型上下文；这只是本地视觉上下文，不是操作日志、聊天记录或项目写入授权。独立 PANEL_URL 页面没有宿主会话桥，也不会伪装成已同步。
npm run lint
npm run build
npm test
npm run repo:check
npm run doctor完整验收用 npm run check，其中包含 plugin 构建、npm run repo:plugin-check 与 setup:codex --dry-run；校验不会修改本机 Codex 配置。新增或移除 MCP 工具、协议字段、plugin 打包或安全边界时，必须同步 AGENTS.md、架构、决策、plugin 目标文档、测试、示例、CI 和两个离线守卫。
四个工具均带显式 MCP annotations：get_board / show_board / scan_project 为只读、非破坏性、封闭本地；draw_board 是可删除或覆盖对象的破坏性写入。任何工具 schema 或行为变化都必须同步这些标注和回归测试。
文档 | 内容 |
英文安装和产品概览 | |
给 AI coding agent 的短操作手册 | |
定义、边界与验收 | |
双身份实测、问题优先级与闭环状态 | |
Codex plugin 的目标、范围与验收 | |
源码结构、协议、HTTP 与安全模型 | |
0.7.0 会话上下文同步与历史 ADR 状态 | |
全部文档入口 | |
首用自检与常见问题 | |
本地验证与 PR 规范 | |
威胁模型与漏洞报告 | |
本地数据、用途、接收方、保存期限与用户控制 | |
问题反馈、支持渠道与安全报告入口 | |
开源许可、项目表面和分发说明 | |
插件目录、隐私、本地状态与帮助入口 | |
仓库已备材料与 OpenAI 侧资格事项 | |
社区参与规则 | |
当前基线与非目标 | |
版本记录 |
MIT. See LICENSE.
让 AI 直接在共享无限画布上画或改，也可通过 library 参数保存当前画板、切换本地画板图库中的图、新建/重命名/复制/删除/导入/导出可编辑版本 1 画板。普通写入会串行应用到最新状态；line 的 (x,y) 是起点，(x+w,y+h) 是终点，w/h 可为负数；其他对象是左上角与宽高。按整齐网格布局；不打开浏览器，不写项目文件。
Inputs: items, author, layout, library, +4 more.
读取人和 AI 共享画布的数据：revision、对象 ID、坐标、作者、BOARD_JSON 和画图规范。用于回答画布内容或给 Agent 提供视觉上下文；只读，不打开浏览器，也不写项目文件。想显示可编辑画布时调用 show_board。
Inputs: no named parameters.
可选能力：只读扫描当前工作区的目录与文件路径，并返回少量 file:line 证据文本。项目结构只是画板可以讨论的内容之一；本工具不生成图、不改画板、不写文件，也不授权代码变更。需要可视化时用 draw_board 把路径画到共享画板。
Inputs: max_depth, max_files, include_evidence.
在人和 AI 的 Agent 对话旁显示共享无限画布，供用户直接查看和编辑。用户要求打开、查看、展示或编辑 Doodle 画布时调用。支持 MCP Apps 的宿主会嵌入交互式画布；其他宿主仍可通过普通工具读写画布。
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Scored across 4 tools
The four tools have mostly distinct purposes: get_board reads canvas data, show_board opens an interactive view, draw_board writes/draws, and scan_project scans workspace files. get_board and show_board could be confused at first, but the descriptions explicitly separate reading data from displaying a canvas.
All tool names follow a consistent verb_noun snake_case pattern: get_board, show_board, draw_board, scan_project. The convention is predictable and easy to map to each tool's action.
Four tools is a compact, well-scoped set for a shared canvas server. The only concern is that draw_board carries many responsibilities, including drawing and board-library management, which could justify splitting but does not make the overall count inappropriate.
The core lifecycle is covered: reading board data, displaying the board, and drawing or modifying it. Minor gaps exist around explicit object deletion, undo, or clear operations, but draw_board's modification capabilities and library actions cover most practical workflows.
Real-time collaborative whiteboard — AI agents and humans edit the same board live over MCP.
Online whiteboard your AI agent draws on: live shared canvases, solo or with your team.
AI agent draws editable hand-drawn diagrams (flowchart, ER, architecture) via MCP, not static images
A collaborative whiteboard your AI assistant can read, fill and show live, with changes you review.
