一个模型上下文协议(MCP)服务器,使AI代理能够程序化地创建,操纵和管理BPMN 2.0(业务流程模型和标记)图表.

□ □ □ 概览

MCP-BPMN为AI助理提供了与业务流程图相通的标准化接口. 它生成有效的BPMN 2.0 XML文件,可以在任何符合BPMN的工具(VS代码BPMN编辑器,Camunda Modeler等)中查看和编辑.

关键特性

• ** 完成 BPMN 2.0 支持**:事件、活动、网关、池和序列
• 美人鱼到BPMN 转换:美人鱼流程图中的靴子BPMN图 -=YTET -伊甸园字幕组=- 翻译: 带有分支处理的网关自动定位
• *************************************************************************************************************************************************************************************************************************************************************** 在视觉工具中将图表保存到本地编辑
• 视线成真**: 连接的精确路由计算
• 企业-软件:按照BPMN标准进行清洁API设计
• ** 无浏览器依赖**: 服务器侧 XML 生成

# # # 快速启动 # # # # # # QQ Quick start

• 安装

QQ 配置

用于 Claude 桌面

添加到您的 Claude 桌面配置文件 :

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

MCP-BPMN Server

A Model Context Protocol (MCP) server that enables AI agents to create, manipulate, and manage BPMN 2.0 (Business Process Model and Notation) diagrams programmatically.

🎯 Overview

MCP-BPMN provides a standardized interface for AI assistants to work with business process diagrams. It generates valid BPMN 2.0 XML files that can be viewed and edited in any BPMN-compliant tool (VS Code BPMN Editor, Camunda Modeler, etc.).

Key Features

• ✅ Complete BPMN 2.0 Support: Events, activities, gateways, pools, and sequences
• ✅ Mermaid to BPMN Conversion: Bootstrap BPMN diagrams from Mermaid flowcharts
• ✅ Smart Auto-Layout: Automatic positioning with branch handling for gateways
• ✅ File Persistence: Save diagrams locally for editing in visual tools
• ✅ Proper Visual Rendering: Accurate waypoint calculation for connections
• ✅ Enterprise-Ready: Clean API design following BPMN standards
• ✅ No Browser Dependencies: Server-side XML generation

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/your-org/mcp-bpmn.git
cd mcp-bpmn

# Install dependencies
npm install

# Build the project
npm run build

# Run tests (optional)
npm test

Configuration

For Claude Desktop

Add to your Claude Desktop configuration file:

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

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

For Other MCP Clients

Use the compiled CommonJS bundle:

node dist/server/bundle.cjs

📚 API Reference

Stateful Context Management

MCP-BPMN uses a stateful API design where you work with one diagram at a time. All operations apply to the current diagram context, eliminating the need for processId parameters.

Creation Tools

new_bpmn

Create a new BPMN process or collaboration diagram and set it as the current context.

{
  name: "Order Processing",
  type: "process" // or "collaboration" (optional, defaults to "process")
}

new_from_mermaid

Create a new BPMN diagram from Mermaid code and set it as the current context.

{
  name: "My Process",
  mermaidCode: "graph TD\n  A[Start] --> B[Task] --> C[End]"
}

File Operations

open_bpmn

Open an existing BPMN file and set it as the current context.

{
  filename: "my-process.bpmn"
}

open_mermaid_file

Open and convert a Mermaid file to BPMN, setting it as the current context.

{
  filename: "my-flowchart.mmd"
}

save

Save the current diagram to its file (requires filename to be set).

{}

save_as

Save the current diagram with a new filename.

{
  filename: "my-process.bpmn"
}

close