Bpmn MCP

🚀 BPMN-MCP

BPMN 2.0ワークフロー図をプログラムで作成および操作するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、AIアシスタントやその他のツールが標準的なBPMN形式でビジネスプロセス図を生成、編集、およびエクスポートできます。

✨ 主な機能

• BPMN図の作成：新しいワークフロー図を最初から生成します。
• プロセス要素の追加：イベント、タスク、ゲートウェイ、サブプロセスを挿入します。
• 要素の接続：ワークフローコンポーネント間にシーケンスフローを作成します。
• エクスポート形式：図をBPMN 2.0 XMLまたはSVGとして保存します。
• インポートサポート：既存のBPMN XMLファイルを読み込んで編集します。
• スマートヒント：適切な接続を持つ完全なワークフローを確保するための役立つヒントを取得します。

📦 インストール

前提条件

• Node.js (v16以上)
• npmまたはyarn

ローカルセットアップ

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

📚 ドキュメント

Claude Desktopの場合

Claude Desktopの設定ファイルに以下を追加します：

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"]
    }
  }
}

/absolute/path/to/BPMN-MCP をこのリポジトリをクローンした実際のパスに置き換えてください。

その他のAIツールの場合

このMCPサーバーは、モデルコンテキストプロトコルをサポートする任意のツールで動作します。実行するように設定します：

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

💻 使用例

設定が完了したら、AIアシスタントにBPMN図を作成するように依頼できます。以下はいくつかの例です：

シンプルなワークフローの作成

次の手順を持つ注文処理ワークフローのBPMN図を作成してください：
1. 注文受付 (開始イベント)
2. 注文検証 (ユーザータスク)
3. 支払い処理 (サービスタスク)
4. 注文完了 (終了イベント)

これらをシーケンスフローで接続してください。

決定ポイントを持つワークフローの作成

顧客サポートチケットルーティングのBPMN図を作成してください：
- 開始: チケット受付
- タスク: チケット分類
- ゲートウェイ: 優先度チェック
  - 高: シニアサポートにエスカレート
  - 通常: サポートチームに割り当て
- 両方のパスは: チケット解決 (終了) につながります。

利用可能なツール

MCPサーバーは以下のツールを提供します：

create_bpmn_diagram

新しいBPMN図を作成し、図IDを返します。

add_bpmn_element

図に要素を追加します。サポートされるタイプ：

• イベント: bpmn:StartEvent, bpmn:EndEvent, bpmn:IntermediateCatchEvent, bpmn:IntermediateThrowEvent
• タスク: bpmn:Task, bpmn:UserTask, bpmn:ServiceTask, bpmn:ScriptTask, bpmn:ManualTask, bpmn:BusinessRuleTask, bpmn:SendTask, bpmn:ReceiveTask
• ゲートウェイ: bpmn:ExclusiveGateway, bpmn:ParallelGateway, bpmn:InclusiveGateway, bpmn:EventBasedGateway
• その他: bpmn:SubProcess

connect_bpmn_elements

2つの要素間にシーケンスフローを作成します。

export_bpmn_xml

図をBPMN 2.0 XML形式でエクスポートします。

export_bpmn_svg

図を可視化用のSVGとしてエクスポートします。

list_bpmn_elements

図内のすべての要素をリストします。

import_bpmn_xml

既存のBPMN XMLファイルを編集用にインポートします。

出力例

サーバーは標準的なBPMN 2.0 XMLファイルを生成し、以下のツールで開くことができます：

• Camunda Modeler
• bpmn.io
• 任意のBPMN 2.0準拠のツール

XML出力の例：

<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL"
                   xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
                   xmlns:dc="http://www.omg.org/spec/DD/20100524/DC"
                   xmlns:di="http://www.omg.org/spec/DD/20100524/DI">
  <bpmn:process id="Process_1" isExecutable="true">
    <bpmn:startEvent id="Event_1" name="Start">
      <bpmn:outgoing>Flow_1</bpmn:outgoing>
    </bpmn:startEvent>
    <bpmn:task id="Task_1" name="Process">
      <bpmn:incoming>Flow_1</bpmn:incoming>
      <bpmn:outgoing>Flow_2</bpmn:outgoing>
    </bpmn:task>
    <bpmn:endEvent id="Event_2" name="End">
      <bpmn:incoming>Flow_2</bpmn:incoming>
    </bpmn:endEvent>
    <bpmn:sequenceFlow id="Flow_1" sourceRef="Event_1" targetRef="Task_1" />
    <bpmn:sequenceFlow id="Flow_2" sourceRef="Task_1" targetRef="Event_2" />
  </bpmn:process>
  <!-- Diagram information omitted for brevity -->
</bpmn:definitions>

開発

開発モードでの実行

npm run watch

これにより、ソースファイルが変更されると自動的にプロジェクトが再構築されます。

テスト

MCPプロトコルを使用してサーバーを手動でテストできます：

node dist/index.js

次に、標準入力を介してJSON-RPCリクエストを送信します。例：

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

🔧 技術詳細

アーキテクチャ

• ランタイム：TypeScriptを使用したNode.js
• BPMNエンジン：bpmn-js (jsdomを使用したヘッドレスモード)
• プロトコル：モデルコンテキストプロトコル (MCP)
• 出力：BPMN 2.0 XML標準

スマートワークフローヒント

サーバーには、完全な図を確保するための役立つヒントが含まれています：

• タスク/イベントを追加するときに要素を接続するように促します。
• 接続されていない要素を含む図をエクスポートするときに警告します。
• 適切なワークフローを作成するために connect_bpmn_elements を使用することを提案します。

📄 ライセンス

MIT

貢献

貢献は大歓迎です！問題やプルリクエストを自由に送信してください。

サポート

問題や質問がある場合は：

• GitHubで問題を開いてください。
• 既存の問題を確認して解決策を探してください。

関連プロジェクト

• bpmn-js - BPMN 2.0レンダリングツールキット
• Model Context Protocol - プロトコル仕様