mlua-swarm

mlua-swarm

flow.ir Blueprint をコンパイルし、エージェントのステップをワーカーにディスパッチする、長時間稼働するスウォームエンジンのホストです。Blueprint では、flow（step / seq / branch / loop / fanout / try / let ノード）と、参照する agents を宣言します。エンジンは各エージェントをバックエンド（プロセス内 Lua、Rust 関数、子プロセス、または対話型 Operator）に割り当て、タスクの状態を記録しながらフローを実行します。

インストール

cargo install mlua-swarm-cli

これにより、次の 2 つのサブコマンドを備えた mse バイナリがインストールされます。

mse serve   # HTTP + WS server (tasks, Blueprint store, WS Operator sessions)
mse mcp     # MCP adapter over stdio, for AI agents (Claude Code etc.)

Blueprint のワンショット実行は swarm_run MCP ツール（mse mcp が公開）から利用できます。このツールは標準の TaskApplication.handle / TaskLaunchService::launch 経路で実行します。

MCP クライアントの設定：

{ "command": "mse", "args": ["mcp"] }

Docker（Rust ツールチェーンは不要）

MCP Registry にも io.github.ynishi/mlua-swarm として掲載されています。

{
  "mcpServers": {
    "mlua-swarm": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/ynishi/mse:latest",
        "mcp"
      ]
    }
  }
}

ドキュメント

ドキュメントはコード自体から提供されます。

• API / アーキテクチャ — docs.rs の rustdoc（クレートルートのドキュメントにアーキテクチャの概要があります）。
• ガイド / サンプル / スキーマ — mse mcp が提供する、同梱の mse:// 配下の MCP リソースです。バイナリと常に同じバージョンです。mse://guides/getting-started、mse://guides/bp-lifecycle（develop → trial-run → operate のワークフロー図）、mse://guides/blueprint-authoring、mse://guides/mcp-tool-reference、mse://blueprints/samples/*、および mse://api/blueprint-schema の最新 Blueprint JSON Schema（bp_schema ツールとしても利用可能）が含まれます。

ワークスペースのクレート

crate	役割
mlua-swarm	エンジンのコア（ワークスペースのルートパッケージ）
mlua-swarm-schema	Blueprint のスキーマ型
mlua-swarm-server	HTTP + WS サーバーライブラリ
mlua-swarm-cli	mse バイナリ

ライセンス

お好みに応じて、Apache License 2.0 または MIT License のいずれかのライセンスが適用されます。