BPMN Collab MCP
Produces standard BPMN 2.0 XML that can be imported into Camunda (and other BPMN tools such as Signavio and ARIS); the server creates, edits, and deterministically validates BPMN diagrams with element-level business metadata embedded via extension elements.
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.
title: BPMN Collab MCP emoji: 🔀 colorFrom: blue colorTo: indigo sdk: docker app_port: 7860 license: mit
bpmn-collab-mcp
Human + AI collaborative BPMN 2.0 modeling, over MCP.
The AI creates and edits standard BPMN 2.0 XML (importable in Signavio, ARIS, Camunda…).
Humans edit the same diagram in a bpmn-js canvas.
Every human edit is stored as a versioned revision; the AI reads what changed (
get_changes_since) before its next move.Comments are anchored on BPMN element ids, so a review can target one gateway instead of the whole diagram.
Business metadata lives inside the XML (
extensionElements, namespacepm:), not in side documents.Deterministic validation guards the file: the LLM proposes, the rules dispose.
Status: proof of concept skeleton. See
docs/architecture.mdand the roadmap below.
Related MCP server: MCP-BPMN Server
Quick start
npm install
npm run build
npm test
npm start # http://localhost:7860 (listens on 127.0.0.1; set HOST=0.0.0.0 in containers)MCP endpoint (streamable HTTP, stateless):
http://localhost:7860/mcpHome page
http://localhost:7860/: list of diagrams (search, open in the web canvas, create a new one).Human canvas:
http://localhost:7860/canvas?id=<diagramId>(the name is the title: click to rename) (the id and URL are returned bycreate_diagram)Inline canvas: in hosts that support MCP Apps (Claude web/Desktop),
create_diagramandget_diagramrender the same canvas in the conversation (ui://bpmn-collab/canvas.html); it talks to the server through app-onlycanvas_*tools and can post "apply the open AI requests" into the chat.Canvas: token simulation (official
bpmn-js-token-simulation, toggle at the top left: start tokens, choose paths at gateways, pause, log; the model is locked and nothing is saved while simulating); events and gateways coloured by type (start green, end red, intermediate orange, gateways yellow; canvas only, the file stays neutral; explicit colours win), same colours on the palette icons; minimap at the bottom of the side panel (officialdiagram-js-minimap, frame + draggable viewport only), zoom bar (−, +, Ajuster which keeps clear of the palette, 100 %, level shown; Ctrl/Cmd + wheel and trackpad pinch from diagram-js), comments drawn as bubbles on their element (AI blue, human orange, resolved grey; click to read the thread and reply), filters show/hide, open/resolved/all, human/AI (remembered in localStorage when available), orphan comments of deleted elements kept in the side panel, click a comment to centre and highlight its element; stacked layout on narrow screens.Export: canvas buttons Télécharger .bpmn / Télécharger SVG (inline in Claude the host performs the download, with a signed link and a copy/paste panel as fallbacks),
GET /api/diagrams/:id/export.bpmn, and signed links fromexport_diagram.Environment:
PORT(7860),HOST(127.0.0.1),PUBLIC_URL,DATA_DIR,EXPORT_SIGNING_SECRET(>= 32 chars, signs download links),OAUTH_ISSUER/OAUTH_ALLOWED_USERS(OAuth on /mcp),ALLOWED_HOSTS(extra Host names accepted, comma-separated; localhost and thePUBLIC_URLhost are always accepted).
Add it to Claude as a custom connector (remote MCP URL, must be public HTTPS), or test locally with the MCP Inspector:
npx @modelcontextprotocol/inspectorMCP tools
The modeling guide (skill/SKILL.md) is sent to the client as the server instructions at connection: Claude follows it without installing any skill.
Tool | Purpose |
| Start, list (most recent first, with each web |
| Current XML (with human edits) + open comments |
| Semantic diff by element id between versions (bpmn-js-differ + |
| Save a revision (optimistic concurrency via |
| Deterministic refactoring: move a fragment (one entry, one exit, no message flow across) into a collapsed sub-process with its own drill-down plane, flows rewired, validated before saving |
| Lint issues with stable fingerprints; false positives set aside with a reason (AI or human), shown greyed in the canvas |
| Deterministic rules: bpmnlint |
| Element-anchored review threads; |
| Latest revision as BPMN XML and a signed download link ( |
Deploying
Production runs on a VPS behind Caddy (HTTPS), with GitHub Actions publishing the image to GHCR and a pull-based update on the server: see docs/deploy.md. /mcp is restricted to Anthropic's egress range and the admin IP, the canvas and API sit behind basic auth, until OAuth (docs/oauth-plan.md).
The Dockerfile is plain and also runs elsewhere (set PUBLIC_URL, DATA_DIR, and ALLOWED_HOSTS when behind a proxy with another host name).
Roadmap
Publish the project rules (
src/lint/rules.ts, already in bpmnlint format) as abpmnlint-plugin-*package.DMN (dmn-js) and forms (form-js) linked from
pm:decisionRef/pm:formRef.Process architecture graph (levels, parent/child,
calledElementlinks) kept next to the BPMN files.Review pass: LLM critique emitted as comments with category and severity.
Auth, persistent storage (SQLite/Postgres), live co-editing (Yjs) if needed.
License: MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Versioned artifact review for people and AI agents, with contextual comments and human control.
Flowcharts that people and agents edit together on one live canvas, exported as Mermaid.
Git collaboration for AI agents and people: tasks, hand-offs, reviews, teams, shared memory.
A shared, governed brain for AI agents: versioned context with approvals, local or hosted.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI-driven graphical diagram creation and manipulation using natural language, with support for BPMN workflows, analysis, and manual editing via the Model Context Protocol.1MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to create and manage one BPMN 2.0 diagram at a time, including Mermaid conversion, validation, layout, persistence, and XML or SVG export.27760 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read, explain, lint, and edit existing BPMN 2.0 files in a repository while preserving diagram layout and structural integrity through parsed-document patch operations.Apache 2.0
- AlicenseBqualityCmaintenanceEnables AI assistants and other tools to create, edit, import, and export BPMN 2.0 workflow diagrams, including through a local browser-based live modeler with explicit save back to the session.11MIT