mcpField
B
Bpmn2ai

Bpmn2ai

ローカル
github.com/kshetra-studioAI・エージェント114 週間前に更新
リポジトリ

Bpmn2ai について

Bpmn2aiは、人間、AIエージェント、自動化システムが協働するワークフロー向けのオープンな記法APMNを定義します。BPMN 2.0との互換性を保ちながら、エージェント向けタスク、ゲート、可観測性要素を加えています。

主な機能

  1. 01BPMN 2.0互換のワークフロー記法
  2. 02エージェント、RAG、MCPのタスク型
  3. 03信頼度・セマンティックルーティングゲート
  4. 04エージェント引き継ぎとメモリノード
  5. 05組み込みの可観測性イベント

活用シーン

  1. 01人間とエージェントが協働するワークフローのモデル化
  2. 02信頼度や意味的な一致によるタスク振り分け
  3. 03プロセス図でのMCPツール呼び出しの表現

MCP 対応

TwinTrack参照コンパイラーのMCPサーバーを提供します。対応クライアントからBPMN XMLの移行、APMNワークフローのコンパイル、モデルレビュー、仕様参照を行えます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "apmn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ]
    }
  }
}
起動コマンドnpx -y mcp-remote

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmcp-remote

ツール

8

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
bpmn_xmlstringはい生の BPMN 2.0 XML 文字列
api_keystringいいえ任意 — MCP 設定ヘッダーに設定されていない場合は、ここに TwinTrack API キーを渡してください。 authenticate() を呼び出して取得してください。

詳細

APMN — AI プロセスモデルと表記法

AI 時代の BPMN です。

BPMN は、ビジネスプロセスの共通言語を世界にもたらしました。
APMN は、エージェント型プロセスの共通言語を世界にもたらします。

ライセンス 仕様バージョン ステータス 作成者

APMN とは？

**AI Process Model and Notation（APMN）**は、人間、AI エージェント、自動化システムが連携するワークフローを設計するための、オープンでベンダー中立なビジュアル表記法標準です。

APMN はBPMN 2.0 のスーパーセットです。すべての APMN ファイルは、有効な BPMN 2.0 XML ドキュメントです。APMN 固有の構成要素は apmn: 拡張名前空間に含まれるため、既存の BPMN ツールでも変更を加えずに APMN ファイルを開けます。

APMN は、BPMN が想定していなかった機能を追加します。

BPMN 2.0APN
決定論的なフローのみ確信度に基づく確率的なルーティング
人間のタスクとサービス呼び出しエージェント、RAG、MCP ツール、ベクトルストア、メモリ
二値ゲートウェイ（はい／いいえ）確信度ゲート、推論ゲート、セマンティックゲート
オブザーバビリティの概念なしオブザーバビリティイベントを表記法に組み込み
マルチエージェントの概念なしエージェントの引き継ぎを第一級のフロー要素として扱う

新しいノードタイプ

ノードタイプ説明
🤖 agentTaskTaskLLM 駆動のタスク。属性：model、system_prompt、tools[]、temperature
📚 ragTaskTask検索拡張生成。属性：vector_store、top_k、similarity_threshold
🔌 mcpToolTaskTaskMCP サーバーのツールを呼び出します。属性：server、tool_name、input_schema
👤 humanInLoopTaskTaskエージェントが提案し、人間が承認します。属性：confidence_threshold、timeout
↗ agentHandoffTask専門エージェントに委任します。マルチエージェントのオーケストレーションです。
🧠 memoryTaskTaskエージェントのメモリ（セッションまたは長期）を読み書きします。
⬡ vectorTaskTaskコンテンツをベクトルストアに埋め込むか、ベクトルストアにクエリします。
📡 observeEventEventトレース／スパンをオブザーバビリティプラットフォーム（LangFuse、Phoenix、OTEL）に送信します。

新しいゲートタイプ

ゲート説明
confidenceGateエージェントの確信度スコア（0.0～1.0）に基づいてルーティングします。二値の exclusiveGateway に代わるものです。
reasoningGateLLM の思考連鎖出力を解析してルーティングします。ハードコードされた条件はありません。
modelVersionGateモデルバージョン間で A/B テストまたはカナリアルーティングを行います。安全なモデルアップグレードのパターンです。
semanticGateベクトル類似度に基づいてルーティングします。入力を意図クラスターと照合します。
mcpGateMCP ツールを呼び出し、その結果（合格／不合格／レビュー）に基づいてルーティングします。
escapeGate自動エスカレーションを行います。エージェントが失敗した場合、タイムアウトした場合、または確信度の下限に達した場合、人間に引き継ぎます。

簡単な例

# APMN v0.1 — Patient Preadmission
# xmlns:apmn="http://apmn.kshetra.studio/ns/1.0"

process:
  id: patient_preadmission
  name: Patient Preadmission
  targets: [orkes, google_adk]

nodes:
  - id: verify_insurance
    type: agentTask
    model: gemini-2.0-flash
    tools: [mcp://insurance-api, mcp://medicare-lookup]
    confidence_threshold: 0.95

  - id: check_policy_docs
    type: ragTask
    vector_store: hospital_policy_kb
    top_k: 5

  - id: gw_confidence
    type: confidenceGate
    source: verify_insurance.confidence
    routes:
      high:   ">= 0.95 → proceed"
      medium: "0.7–0.95 → human_review"
      low:    "< 0.7 → escalate"

  - id: compliance_check
    type: mcpToolTask
    server: mcp://compliance-checker.kshetra.studio
    tool: check_hipaa_consent

  - id: log_trace
    type: observeEvent
    platform: langfuse
    trace_name: insurance_verification

リファレンス実装

**TwinTrack**は、APMN のリファレンスコンパイラーです。

APMN YAML / BPMN 2.0 + apmn: XML
             ↓
         TwinTrack
        /         \
Orkes JSON   Google ADK Python   (LangGraph, AWS Bedrock — coming)

BPMN 2.0 との関係

APMN は置き換えではなく、スーパーセットとして設計されています。

  • APMN YAML ファイルを主な作成形式とします（人間が読みやすく、差分を確認しやすい形式です）
  • APMN は、代替入力形式として apmn: 拡張要素を含む BPMN 2.0 XML もサポートします
  • 既存の BPMN 2.0 ノードタイプ（serviceTask、userTask、parallelGateway など）はすべて有効な APMN であり、変更されずに引き継がれます
  • APMN 拡張要素は、これらをサポートしない BPMN ツールでは無視されるため、完全な後方互換性があります

仕様

TwinTrack MCP サーバー

TwinTrackは、APMN のリファレンスコンパイラーです。MCP サーバーを公開しているため、MCP 互換の AI クライアントであれば、APMN ワークフローを直接変換してコンパイルできます。

ツール
ツール説明コスト
migrate_bpmnBPMN 2.0 XML → APMN YAML に変換します1 クレジット
compile_apmnAPMN YAML → Orkes JSON または Google ADK Python にコンパイルします1 クレジット
suggest_node_upgradeノードをより適切な APMN タイプにアップグレードするためのガイダンスを提供します無料
review_modelAPMN モデル全体をベストプラクティスに照らしてレビューします無料
get_apmn_spec任意の APMN ノードタイプの仕様とプラットフォームの対応関係を取得します無料
list_samples同梱のデモ用 BPMN ファイルを一覧表示します無料
接続

Claude Desktop / Cursor — claude_desktop_config.json に追加します：

"twintrack": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://bpmn2ai.kshetra.studio/mcp/", "--header", "X-Api-Key: YOUR_KEY"]
}

Claude Code CLI：

claude mcp add --transport http twintrack https://bpmn2ai.kshetra.studio/mcp/ --header "X-Api-Key: YOUR_KEY"

API キーは bpmn2ai.kshetra.studio で取得できます。無料プランをご利用いただけます。

ロードマップ

バージョンテーマ
v0.1（現在）コアノードタイプ、ゲート、YAML スキーマ、XSD 拡張
v0.2ビジュアルシェイプライブラリ、BPMN.io プラグイン
v0.3VS Code 拡張機能、APMN Playground
v1.0安定した仕様、複数のリファレンス実装
v2.0OMG BPMN 3.0 ワーキンググループへの提出

貢献

APMN は、オープンなコミュニティ標準として運営されています。CONTRIBUTING.md をご覧ください。

仕様の明確化、新しいノードタイプの提案、ワークフローの例、ツールなど、あらゆる貢献を歓迎します。

ライセンス

Apache License 2.0 — LICENSE をご覧ください。

APN 仕様およびこのリポジトリ内のすべての成果物は、制限なく自由に使用、実装、拡張できます。

APMN は Kshetra Studio によるオープン標準の取り組みです。
ウェブサイト：apmn.kshetra.studio · GitHub：kshetra-studio/apmn

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。