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

Built distribution (wheel)

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

Total release size: 128.4 kB

Release files / appkit_mcp_bpmn-1.17.2.tar.gz

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

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