appkit-mcp-bpmn
MCP server component for generating and viewing BPMN 2.0 diagrams.
Features
- Generate BPMN diagrams from natural language descriptions via LLM
- Save & validate BPMN 2.0 XML with schema-aware validation
- Render diagrams in-browser using bpmn-js Viewer (read-only)
- Download diagrams as
.bpmnfiles - Public API — no authentication required
MCP Tools
generate_bpmn_diagram
Generate a BPMN 2.0 diagram from a natural language description.
Parameters:
description(str, required): Workflow description in natural languagediagram_type(str, optional):"process"|"collaboration"|"choreography"(default:"process")
Returns: JSON with {success, id, xml, download_url, view_url, error}
save_bpmn_diagram
Save pre-built BPMN 2.0 XML to the filesystem.
Parameters:
xml(str, required): Complete BPMN 2.0 XML string
Returns: JSON with {success, id, xml, download_url, view_url, error}
MCP Resource
ui://appkit/bpmn_viewer.html
Interactive BPMN diagram viewer powered by bpmn-js. Renders tool results via the MCP App ui/notifications/tool-result protocol.
Features:
- Zoom to fit viewport
- Download diagram as
.bpmnfile - Error display for invalid XML
Quick Start
from appkit_mcp_bpmn.server import create_bpmn_mcp_server
mcp = create_bpmn_mcp_server()
app = mcp.http_app(path="/mcp", transport="streamable-http")
Example Workflow
1. User: "Create an expense approval workflow"
2. LLM calls generate_bpmn_diagram(description="...", diagram_type="process")
3. Server generates XML via LLM, validates, saves to uploaded_files/
4. Returns {id, view_url, download_url}
5. MCP App renders diagram in bpmn-js Viewer
Dependencies
appkit-commons— Configuration and loggingappkit-mcp-commons— Shared MCP base modelslxml— XML parsing and validationopenai(optional) — LLM generation via OpenAI API
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file appkit_mcp_bpmn-1.13.3.tar.gz.
File metadata
- Download URL: appkit_mcp_bpmn-1.13.3.tar.gz
- Upload date:
- Size: 69.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e5df9ce54ecd75c9cca69603e55b6ebcbb5498b97f4d8c4f73279442753acd0
|
|
| MD5 |
b0f78d7a3108b10754cb85323f531a7e
|
|
| BLAKE2b-256 |
23e3fd3736b4d13aba1b6588b9654ee3b6e93e52fd6d4ec32aa44c70b769d5ca
|
File details
Details for the file appkit_mcp_bpmn-1.13.3-py3-none-any.whl.
File metadata
- Download URL: appkit_mcp_bpmn-1.13.3-py3-none-any.whl
- Upload date:
- Size: 58.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7db6ed450f6e0deda5df0079a166203d136cc7ff6b9dea2b7ed202aa8e3df547
|
|
| MD5 |
8ada55882eb17fc96f1e7e6ef1fdeef2
|
|
| BLAKE2b-256 |
8ca04e207a4a52181b917d0a092c3b8f2c407a6f84bf56b626ef790ee647b1ff
|
