BPMN-MCP

A Model Context Protocol (MCP) server for creating and manipulating BPMN 2.0 workflow diagrams programmatically. This server enables AI assistants and other tools to generate, edit, and export business process diagrams in the standard BPMN format.

Features

• Create BPMN Diagrams: Generate new workflow diagrams from scratch
• Add Process Elements: Insert events, tasks, gateways, and subprocesses
• Connect Elements: Create sequence flows between workflow components
• Export Formats: Save diagrams as BPMN 2.0 XML or SVG
• Import Support: Load and modify existing BPMN XML files
• Smart Hints: Get helpful nudges to ensure complete workflows with proper connections

Installation

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Local Setup

1. Clone the repository:

git clone https://github.com/dattmavis/BPMN-MCP.git
cd BPMN-MCP

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

For Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bpmn": {
      "command": "node",
      "args": ["/absolute/path/to/BPMN-MCP/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/BPMN-MCP with the actual path where you cloned this repository.

For Other AI Tools

This MCP server works with any tool that supports the Model Context Protocol. Configure it to run:

node /path/to/BPMN-MCP/dist/index.js

Usage

Once configured, you can ask your AI assistant to create BPMN diagrams. Here are some example requests:

Creating a Simple Workflow

Create a BPMN diagram for an order processing workflow with these steps:
1. Order Received (start event)
2. Validate Order (user task)
3. Process Payment (service task)
4. Order Complete (end event)

Connect them with sequence flows.

Creating a Workflow with Decision Points

Create a BPMN diagram for customer support ticket routing:
- Start: Ticket Received
- Task: Categorize Ticket
- Gateway: Check Priority
  - If High: Escalate to Senior Support
  - If Normal: Assign to Support Team
- Both paths lead to: Ticket Resolved (end)

Available Tools

The MCP server provides these tools:

create_bpmn_diagram

Creates a new BPMN diagram and returns a diagram ID.

add_bpmn_element

Adds an element to the diagram. Supported types:

• Events: bpmn:StartEvent, bpmn:EndEvent, bpmn:IntermediateCatchEvent, bpmn:IntermediateThrowEvent
• Tasks: bpmn:Task, bpmn:UserTask, bpmn:ServiceTask, bpmn:ScriptTask, bpmn:ManualTask, bpmn:BusinessRuleTask, bpmn:SendTask, bpmn:ReceiveTask