Skedra Whiteboard

面向用户与 AI Agent 的开源白板。

可自托管。支持协作。Agent 可编辑。AGPL-3.0。

网站 · 文档 · 自托管 · MCP · React SDK · Discord

Skedra 是一块无限画布，可用于草图、图表、看板和甘特时间线。 与团队实时协作，或通过内置 MCP 服务连接 AI Agent。 在自己的基础设施上运行完整应用。无需 Skedra 订阅、许可服务器或中央 Skedra 账户， 即可使用所有功能。

skedra.xyz 提供文档和项目信息。 应用、API、MCP 服务、库目录、数据库、SDK 和部署 文件都位于此代码仓库中。没有单独的商业版本。

自托管 Skedra

运行一体化 Docker 镜像：

docker run -d \
  --name skedra \
  -p 3000:80 \
  -v skedra_data:/data \
  ghcr.io/moonriddim/skedra-community-standalone:latest

打开 http://localhost:3000。PostgreSQL、文件和实例 密钥会保存在 skedra_data 卷中。第一个注册的用户将成为 实例管理员。默认情况下，后续用户需要通过邀请才能注册。

请参阅 SELFHOST.md，了解 Docker Compose、生产环境 URL、存储、 可选的 LiveKit 通话、更新和备份。此过渡版本的镜像将在更改合并且发布工作流成功后 提供。

功能

• 无限画布，支持文本、形状、箭头、绘图、图片和画框。
• 原生流程图、时序图、看板、甘特图和模板。
• 本地浏览器白板和便携式 .skedra 文件。
• 账户、团队、角色、权限、评论、提及和白板动态。
• 实时协作、加密存储和可选的端到端加密。
• 分享链接、演示和只读嵌入。
• MCP 服务包含 23 个工具，支持结构化、可编辑的 Agent 工作流。
• 形状库支持导入 .skedralib 文件，并提供可自托管目录。
• 可选 AI，支持使用自有服务提供商或本地模型；也可选用 LiveKit 通话。
• 可嵌入的 React SDK，使用相同的画布模型、渲染器和编辑器。

面向 AI Agent 的 MCP

将 Codex、Claude、Cursor 或其他客户端连接到自己的实例：

https://YOUR-SKEDRA-INSTANCE/api/mcp

通过 OAuth 登录该实例。API 密钥和本地 stdio 配置 可在设置 > API 密钥与 MCP中找到。没有中央托管的 MCP 端点。请参阅 docs/MCP.md。

开发

git clone https://github.com/moonriddim/skedra-community.git
cd skedra-community
corepack enable
docker compose -f docker-compose.dev.yml up -d
cp .env.example .env
pnpm install
pnpm db:push
pnpm dev

打开 http://localhost:5174。 pnpm dev 也会监视共享 SDK。使用 pnpm sdk:verify 执行有针对性的 SDK 和 编辑器一致性检查。pnpm test 会运行工作区测试。

使用 pnpm docs:build 构建独立的静态网站，并使用 pnpm docs:dev 在 http://localhost:5176 上预览。 它无需 API、数据库、身份验证或外部服务。

代码仓库

• apps/web、apps/api、apps/mcp、apps/libraries：可自托管的应用。
• apps/docs：静态项目网站和文档。
• packages：数据库、共享类型、画布核心、编辑器、渲染器、IO 和 React SDK。
• deploy：自托管、数据库迁移和反向代理。
• .github/workflows：直接从此代码仓库执行检查和发布。

欢迎贡献。请阅读 CONTRIBUTING.md，在 GitHub Issues 中报告问题，或加入 Discord。

许可证

Skedra 根据 AGPL-3.0-only 许可。您可以根据该许可证使用、修改、再分发和托管 Skedra，包括用于商业用途。第三方材料仍遵循其自身条款。您创建的看板和导出内容仍归您所有。 请参阅 LICENSING.md 和迁移指南。