Skip to content

Add mcp-swarm: parallel Claude agent orchestration via Docker#1072

Open
stiege wants to merge 1 commit intomodelcontextprotocol:mainfrom
stiege:add-mcp-swarm
Open

Add mcp-swarm: parallel Claude agent orchestration via Docker#1072
stiege wants to merge 1 commit intomodelcontextprotocol:mainfrom
stiege:add-mcp-swarm

Conversation

@stiege
Copy link

@stiege stiege commented Mar 17, 2026

Server details

Name: io.github.stiege/mcp-swarm
PyPI package: mcp-swarm (v0.1.1)
GitHub: https://github.com/stiege/swarm-mcp
Docs: https://stiege.github.io/swarm-mcp

What it does

mcp-swarm is an MCP server that gives Claude Code the ability to orchestrate N parallel agents, each running in an isolated Docker container. It provides functional combinators for composing agent work:

  • run — single agent in isolation
  • par — N agents in parallel
  • map / map_reduce — fan-out over inputs, optional synthesis
  • chain / pipeline — sequential stages with on_fail, next jumps, max_retries
  • filter / retry / guard — type-validated loops
  • reduce — synthesise multiple results into one

Outputs are lazy refs (metadata only) until unwrap() materialises the text — so a pipeline fanning out to 50 agents doesn't flood the MCP protocol.

The natural language type system lets you define what agents should produce as markdown prose ("The analysis must identify at least 3 risk factors"), validated by a LLM judge returning VALID/PARTIAL/INVALID with per-criterion feedback.

Ownership verification

The <!-- mcp-name: io.github.stiege/mcp-swarm --> comment is present at the top of the README.md.

Install

uvx mcp-swarm

Adds io.github.stiege/mcp-swarm to the registry.

mcp-swarm is an MCP server that lets Claude Code orchestrate N parallel
agents in Docker containers using functional combinators (map, par, chain,
reduce, map_reduce, pipeline), lazy monadic refs, and a natural language
type system for semantic output validation.

PyPI: mcp-swarm 0.1.1
GitHub: https://github.com/stiege/swarm-mcp
Docs: https://stiege.github.io/swarm-mcp

Ownership verified via <!-- mcp-name: io.github.stiege/mcp-swarm --> in README.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant