Repository navigation
Releases
v1.2.2
What's Changed in v1.2.2
🐛 Bug Fixes
- fix(ci): repair broken release.yml action pins (#19)
Full Changelog: v1.2.1...v1.2.2
npm install excalidraw-mcp-sentinel@1.2.2
What's Changed
Full Changelog: v1.2.1...v1.2.2
v1.2.1
Fixed
- Stale
celstnblaccorg references corrected toartificemachine(GitHub org) across package.json, Dockerfile labels, README, CI workflows, skill docs. - Docker image namespace corrected to
newblacc(Docker Hub account) —artificemachinewas never a Docker Hub org.
Published
- npm:
excalidraw-mcp-sentinel@1.2.1 - Docker Hub:
newblacc/excalidraw-mcp-sentinel:1.2.1/latest,newblacc/excalidraw-mcp-sentinel-canvas:1.2.1/latest
Known issue
release.ymlCI automation is currently broken (stale action-pin SHAs) and the repo has noNPM_TOKEN/DOCKERHUB_*/APP_IDsecrets configured — this release was published manually. Needs a follow-up fix before future releases can be fully automated.
v1.2.0 — Streamable HTTP transport: one shared MCP process for all sessions
What's new in v1.2.0
Added
- Streamable HTTP transport mode (
MCP_TRANSPORT=http): a single long-lived process now serves all MCP clients over HTTP instead of spawning a new stdio process per Claude Code session. Each client session gets its own isolatedServerinstance, routed bymcp-session-idheader. src/mcp-http.ts:mountMcpRoutes,startMcpHttpServer,resolveTransportMode— full HTTP session lifecycle (POST/GET/DELETE /mcp, session map, StreamableHTTPServerTransport from @modelcontextprotocol/sdk 1.26+)createMcpServer()factory +registerHandlers()insrc/index.tsfor clean per-session server instantiation in HTTP mode- 9 new tests in
tests/backend/mcp-http.test.tscovering transport resolution, session isolation, teardown, andstartMcpHttpServer
Changed
runServer()now checksMCP_TRANSPORTenv var; defaults to stdio (fully backward-compatible)fs.writeFileSync/readFileSyncin export/import tool handlers upgraded tofs.promisesasync variants
Total test coverage: 528 tests (31 test files), all passing
v1.0.6
Added
DELETE /api/tenants/:idendpoint — delete workspaces with cascade (projects, elements, snapshots)- Workspace delete UI: inline confirm buttons in the workspace switcher panel
Fixed
- Project switch in browser did not load new project's elements — now directly clears canvas and reloads
Full Changelog: v1.0.5...v1.0.6
v1.0.5
What's Changed
Added
- Project management UI in canvas header: create, switch, delete projects with inline confirm
- Sync countdown timer showing seconds until next auto-sync after drawing stops
- REST endpoints:
GET /api/projects,POST /api/projects,PUT /api/project/active,DELETE /api/projects/:id - E2e test suite for project switching round-trips
- Sync countdown unit tests with fake timers
Fixed
resolveTenantProjectalways returned first project by creation date instead of the active project — switching projects now correctly loads each project's elementsresolveScopehad the same bug, causing WebSocket broadcasts to target the wrong project- Switching projects while a sync countdown was pending could overwrite the new project's elements — pending sync now auto-saves before switching
onChangetriggered sync countdown on selection/appState changes — added element hash comparison to filter false triggers
Changed
- Test count: 477/477 (up from 446)
Full Changelog: v1.0.4...v1.0.5
v1.0.1 — Fix Node.js version mismatch
Bug Fix
Fixed
better-sqlite3native module now rebuilt on install viapostinstallscript, fixingERR_DLOPEN_FAILEDwhen installing vianpxon a different Node.js version than was used to publish (e.g. Node v22 vs v25)
Install
```bash
npx excalidraw-mcp-sentinel@latest setup
```
v1.1.0 — Native field preservation, label materialization, batch workspace delete
What's new
Native Excalidraw field preservation
Every element written to the database now has all required native Excalidraw fields populated with correct defaults (fillNativeFields in db layer). Elements are identical to those produced by the VSCode Excalidraw extension — correct roundness, seed, versionNonce, index, strokeColor, etc.
Bound text materialization
containerId ↔ boundElements bidirectional binding is enforced on every write path (repairContainerBinding). Text labels now follow their container when moved in the canvas.
Server-side label materialization
MCP create_element/update_element calls with label.text or text on a shape now produce a native bound text element at write time (materializeLabel in server.ts). No more MCP label stubs — elements are stored in proper Excalidraw format from the start.
Batch workspace delete
- New UI: Select/Unselect All, per-row checkboxes, Delete N workspaces button with confirmation
- New endpoint:
POST /api/tenants/batch-delete— delete up to 50 tenants in one request
Tests
42 new backend non-regression tests covering all new behavior. 519 tests total passing.
Full changelog
See CHANGELOG.md for the complete entry.
v1.0.0 — excalidraw-mcp-sentinel
First release as excalidraw-mcp-sentinel
Forked from sanjibdevnathlabs/mcp-excalidraw-local with production hardening.
What's included
- 32 MCP tools over stdio — works with Claude Desktop, Cursor, OpenCode, Codex CLI
- SQLite persistence with versioning, multi-tenancy, and full-text search
- Real-time Excalidraw canvas synced via WebSocket
- 369 tests (upstream has none)
- Security middleware: helmet, rate limiting, API key auth, prototype pollution guard, WS challenge-response
- Docker: non-root user, resource limits
Install
```bash
npx excalidraw-mcp-sentinel setup
```
Or from source:
```bash
git clone https://github.com/celstnblacc/excalidraw-mcp-sentinel.git
cd excalidraw-mcp-sentinel
npm install && npm run build
```
Full changelog
See CHANGELOG.md