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.17.0

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.17.0
File Size Uploaded Provenance Actions
appkit_mcp_bpmn-1.17.0.tar.gz 69.4 kB Without provenance Details for appkit_mcp_bpmn-1.17.0.tar.gz

Built distribution (wheel)

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

Total release size: 128.4 kB

Release files / appkit_mcp_bpmn-1.17.0.tar.gz

Download URL appkit_mcp_bpmn-1.17.0.tar.gz
Size 69.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4a8055183e80307aeff84c14ed303cc6447486372a44c086b312310267b8bff5
BLAKE2b-256 checksum
How to use checksums
189a8d200764c9b4c8ce39c9bd278abe0a0cd7f3c18737716f66c33f817e0938
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.17.0-py3-none-any.whl

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

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.17.0 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