Skip to main content

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 .bpmn files
  • 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 language
  • diagram_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 .bpmn file
  • 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 logging
  • appkit-mcp-commons — Shared MCP base models
  • lxml — XML parsing and validation
  • openai (optional) — LLM generation via OpenAI API

Metadata

Release files for appkit-mcp-bpmn 1.16.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for appkit-mcp-bpmn 1.16.2
File Size Uploaded Provenance Actions
appkit_mcp_bpmn-1.16.2.tar.gz 69.4 kB Without provenance Details for appkit_mcp_bpmn-1.16.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for appkit-mcp-bpmn 1.16.2
File Interpreter ABI Platform Actions
appkit_mcp_bpmn-1.16.2-py3-none-any.whl Python 3 none any Details for appkit_mcp_bpmn-1.16.2-py3-none-any.whl

Total release size: 128.4 kB

Release files / appkit_mcp_bpmn-1.16.2.tar.gz

Download URL appkit_mcp_bpmn-1.16.2.tar.gz
Size 69.4 kB
Tags Source
SHA-256 checksum
How to use checksums
edb09d6e46a809ec8e0284a8f2262af19681c86c97f730f5fafe9bf1f452cd1d
BLAKE2b-256 checksum
How to use checksums
270292e075b759b51b28de0560913f28ca3a9e2d30bee31bac64e3967abb072c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}

Release files / appkit_mcp_bpmn-1.16.2-py3-none-any.whl

Download URL appkit_mcp_bpmn-1.16.2-py3-none-any.whl
Size 59.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a636aca2d63a5b3c04bd27784ab2ad58b87078e27d751de90d11e2f9a7cdb97
BLAKE2b-256 checksum
How to use checksums
095ddecb0c7ba2de1f1db43f0489c36e78fdc6c5e3cdb710c214100828f9efd6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}

Security for appkit-mcp-bpmn 1.16.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.16.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page