Mlua Swarm

io.github.ynishi由 GitHub 账号 ynishi 发布v0.32.1更新于 Oct 24, 2026

MCP server for mlua-swarm: engine that compiles flow.ir Blueprints and dispatches agent steps.

已验证STDIO仅桌面开发者工具AI 与机器学习

概览

AI 生成的概览

mlua-swarm 引擎的 MCP 适配器，可编译 flow.ir Blueprint 并把其中的 agent 步骤分派给 worker 执行。

可以做什么
  • 通过 swarm_run 工具一次性运行 Blueprint，走引擎标准的任务启动路径。
  • 读取 mse:// 下随附的文档资源，包括入门、Blueprint 生命周期、编写指南和 MCP 工具参考。
  • 获取示例 Blueprint 与实时的 Blueprint JSON Schema，也可通过 bp_schema 工具取得。
  • 驱动由 step、seq、branch、loop、fanout、try、let 节点组成的流程，agent 可解析为进程内 Lua、Rust 函数、子进程或交互式 Operator。
适用场景
适合让助手编写、校验并执行 mlua-swarm Blueprint，并在同一个 MCP 会话中编排多步骤 agent 工作流。更适合已经在使用 mlua-swarm 引擎的团队，而非通用自动化场景。
运行要求
以 stdio 在本地运行。可用 cargo install mlua-swarm-cli 安装 mse 二进制，并配置命令 mse、参数 mcp；或用 docker run -i --rm 加 mcp 参数运行已发布的容器镜像。未声明任何认证、环境变量或请求头。
安装前请注意
执行 Blueprint 会分派 agent 步骤，可能启动子进程或交由交互式 Operator 处理，运行前应先确认 Blueprint 引用了什么。引擎还会记录任务状态；另外 mse serve 模式会开放 HTTP 与 WebSocket 服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mlua Swarm，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mlua-swarm

A long-running swarm engine host that compiles flow.ir Blueprints and dispatches their agent steps to workers. A Blueprint declares a flow (step / seq / branch / loop / fanout / try / let nodes) plus the agents it references; the engine resolves each agent to a backend (in-process Lua, a Rust function, a child process, or an interactive Operator) and drives the flow while recording task state.

Install

bash
cargo install mlua-swarm-cli

This installs the mse binary with two subcommands:

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

One-shot Blueprint execution is available through the swarm_run MCP tool (exposed by mse mcp), which runs through the canonical TaskApplication.handle / TaskLaunchService::launch path.

MCP client config:

json
{ "command": "mse", "args": ["mcp"] }
Docker (no Rust toolchain required)

Also listed on the MCP Registry as io.github.ynishi/mlua-swarm:

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

Documentation

Documentation is served from the code itself:

  • API / architecture — rustdoc on docs.rs (the crate root doc is the architecture overview).
  • Guides / samples / schema — bundled MCP resources under mse://, served by mse mcp and always version-matched to the binary: mse://guides/getting-started, mse://guides/bp-lifecycle (the develop → trial-run → operate workflow map), mse://guides/blueprint-authoring, mse://guides/mcp-tool-reference, mse://blueprints/samples/*, and the live Blueprint JSON Schema at mse://api/blueprint-schema (also available as the bp_schema tool).

Workspace crates

craterole
mlua-swarmengine core (workspace root package)
mlua-swarm-schemaBlueprint schema types
mlua-swarm-serverHTTP + WS server library
mlua-swarm-clithe mse binary

License

Licensed under either of Apache License 2.0 or MIT License at your option.

来源：README.md，提交 97e2112

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

5
  1. v0.32.1最新Oct 19, 2026
  2. v0.32.0Oct 19, 2026
  3. v0.31.0Oct 18, 2026
  4. v0.30.0Oct 18, 2026
  5. v0.29.0Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分