简介
coldrawdb 使用 Rust + Leptos / WASM 构建浏览器编辑器,以 actix-web + SQLite 提供持久化、用户鉴权和实时协作。可以通过 Docker 自托管,也可以从源码运行,并通过本地 MCP 服务让 AI 客户端参与图表编辑。
- :表、字段、关系、索引、枚举、自定义类型、区域、备注和待办;支持画布与列表视图、关系推断、自动布局、表尺寸调整、关系颜色与线型。
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
coldrawdb 使用 Rust + Leptos / WASM 构建浏览器编辑器,以 actix-web + SQLite 提供持久化、用户鉴权和实时协作。可以通过 Docker 自托管,也可以从源码运行,并通过本地 MCP 服务让 AI 客户端参与图表编辑。
Rust 全栈数据库 ERD 设计工具——Leptos/WASM 画布编辑器 + actix-web 后端 + SQLite,内置房间协作、数据字典、真实库结构导入与 MCP 服务,单容器 Docker 部署。A full-stack database ERD designer in Rust: Leptos/WASM canvas editor + actix-web backend + SQLite, with room collaboration, data dictionaries, live database introspection, an MCP server, and single-container Docker deployment.
正式部署使用 Docker 镜像与 Compose。Windows / macOS 可使用 Docker Desktop,Linux 使用 Docker Engine + Compose v2。镜像发布工作流配置了 linux/amd64 和 linux/arm64。
从仓库的 GitHub Releases 页面下载 coldrawdb-<tag>-deploy.zip,解压到独立目录。压缩包内容位于根目录,可用系统解压工具,或执行:
# 将 <tag> 替换为下载的版本
unzip 'coldrawdb-<tag>-deploy.zip' -d coldrawdb-deploy
cd coldrawdb-deploy
docker compose up -d
浏览器访问 http://localhost:9080/,注册 / 登录后创建房间开始编辑。部署包会拉取对应版本的 GHCR 镜像,无需安装 Rust 或本地编译。停止服务使用 docker compose down。
跨机器访问时,在部署目录的 .env 中设置实际可访问的前端地址;改变端口时同时更新邀请链接基址:
COLDRAWDB_HTTP_PORT=9080
PUBLIC_BASE_URL=http://192.168.1.10:9080
然后重新运行 docker compose up -d。PUBLIC_BASE_URL 应指向浏览器访问的 SPA 入口。
nginx 默认通过宿主机 9080 端口提供统一入口。./data/,日志位于 ./logs/,备份侧车每日打包数据目录至 ./backups/。http://localhost:9080/api/v1/diagrams/health。restart: unless-stopped;健康检查失败本身不会触发容器重启。源码构建部署:在仓库根目录运行 docker compose up -d --build。发布镜像与部署包分别由 docker.yml 和 release.yml 生成。
cargo install --locked trunk。rustup target add wasm32-unknown-unknown。在仓库根目录执行:
./scripts/start-local.sh
# 前端:http://127.0.0.1:8080/editor
# 后端:http://127.0.0.1:3000
./scripts/stop-local.sh
脚本先编译后端,再启动后端与 Trunk,自动注入前端 API 地址及邀请链接基址。日志写入 logs/。可通过 COLDRAWDB_BACKEND_PORT / COLDRAWDB_FRONTEND_PORT 调整端口;首次前端编译较慢时可设置 COLDRAWDB_FRONTEND_TIMEOUT=300。
从仓库根目录分别在两个终端执行:
# 终端一:后端
cd backend
PUBLIC_BASE_URL=http://127.0.0.1:8080 cargo run --release
# 终端二:前端
cd frontend-rs
COLDRAWDB_API_BASE=http://127.0.0.1:3000 trunk serve --port 8080
后端读取 backend/config.toml;首次启动建立基线表,再执行 backend/migrations/*.up.sql,版本记录在 schema_migrations。本地默认数据库为 backend/db.sqlite。
COLDRAWDB_API_BASE 是前端编译期配置,开发时必须与后端地址一致。生产同源部署构建时应取消该变量,使 API 与 WebSocket 使用页面所在域名。
# 以下命令均从仓库根目录执行
(cd backend && cargo build --release)
(cd frontend-rs && env -u COLDRAWDB_API_BASE trunk build --release --no-wasm-opt)
# 前端产物:frontend-rs/dist/
接口检查:
curl http://127.0.0.1:3000/api/v1/diagrams/health
curl -X POST http://127.0.0.1:3000/api/v1/diagrams \
-H 'Content-Type: application/json' \
-d '{"name":"demo","database":"mysql"}'
coldrawdb-mcp 是独立的本地 stdio 服务,仓库提供 Claude、Codex、Cursor、OpenCode 的配置模板。
./scripts/build-mcp.sh
# 产物:mcp-server/target/release/coldrawdb-mcp
配置 COLDRAWDB_BASE_URL 为后端可访问的基址,例如本地开发的 http://127.0.0.1:3000,或 Compose 入口 http://localhost:9080;不要附加 /api/v1。
update_diagram 使用 expected_revision 防止覆盖并发修改;删除需要 confirm=true。房间图更新收到 USE_OP_CHANNEL 后会转为 WebSocket 差异操作,该路径需要有效的 COLDRAWDB_ACCESS_TOKEN 与房间写入权限。配置与边界见 MCP README。
前端主体使用 Rust,Monaco 和浏览器测试包含 JavaScript / TypeScript。架构说明见 架构概览。
以下 HTTP 分组挂载于 /api/v1,WebSocket 使用独立路径。端点数按当前路由注册统计:
兼容路由还包括 /diagrams/*、/tables/*、/todos/*;MCP 列表读取使用 /diagrams/queryAll。契约入口为 logos/resources/api/。
当前代码已覆盖 S01 / S02 编辑保存与分享加载、S03 鉴权、S04 房间管理、S05 前端实时协作、S06 MCP 和 S07 数据字典。资源索引中 S03~S07 的流程状态仍为 in-progress;代码实现范围与正式验收状态应分别查看,不能据此视为所有场景已通过发布验收。
请阅读 贡献指南,其中说明开发环境、测试入口、Issue / PR 要求及 OpenLogos 变更流程。源码变更需要先完成设计与变更提案。
产品理念与交互设计借鉴 drawDB 与 PDManer 元数建模。开发过程中参考 drawDB 源码进行能力对齐,核心应用以 Rust 重新实现;感谢这些项目提供的设计启发。
本项目采用 MIT 许可证。
Rust 全栈数据库 ERD 设计工具——Leptos/WASM 画布编辑器 + actix-web 后端 + SQLite,内置房间协作、数据字典、真实库结构导入与 MCP 服务,单容器 Docker 部署。A full-stack database ERD designer in Rust: Leptos/WASM canvas editor + actix-web backend + SQL
Übersicht
Rust 全栈数据库 ERD 设计工具——Leptos/WASM 画布编辑器 + actix-web 后端 + SQLite,内置房间协作、数据字典、真实库结构导入与 MCP 服务,单容器 Docker 部署。A full-stack database ERD designer in Rust: Leptos/WASM canvas editor + actix-web backend + SQLite, with room collaboration, data dictionaries, live database introspection, an MCP server, and single-container Docker deployment.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Coldrawdb läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Rust 全栈数据库 ERD 设计工具——Leptos/WASM 画布编辑器 + actix-web 后端 + SQLite,内置房间协作、数据字典、真实库结构导入与 MCP 服务,单容器 Docker 部署。A full-stack database ERD designer in Rust: Leptos/WASM canvas editor + actix-web backend + SQLite, with room collaboration, data dictionaries, live database introspection, an MCP server, and single-container Docker deployment.