Ruv Swarm
by ruvnetcommunityv1.0.19
345
96
ruv-swarm is a Rust/WebAssembly-based swarm orchestration library and CLI for creating and coordinating temporary specialized agents and neural-model-based workflows. It supports topologies like mesh, hierarchical, clustered, and pipeline, plus an MCP server mode for Claude Code integration.
From the registry: Neural network swarm orchestration with WebAssembly acceleration and MCP integration
Install & configure
Prerequisites
- requiredInstall Node.jsNode.js is required to run the recommended NPX-based setup. The README states Node.js 14.0.0 or higher, with v18+ recommended, and WebAssembly support is required.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `ruv-swarm` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js is required to run the recommended NPX-based setup. The README states Node.js 14.0.0 or higher, with v18+ recommended, and WebAssembly support is required.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["ruv-swarm","mcp","start"]
- optional environment variables:
- `SWARM_CONFIG`: Swarm configuration profile to use for the MCP server. (example: `<your-swarm-config>`)
- `MAX_AGENTS`: Maximum number of agents the swarm may create. (example: `<your-max-agents>`)
Note: The README shows an MCP config snippet using stdio with `npx ruv-swarm mcp start`, even though examples also mention `--port 3000` and WebSocket access at localhost. Per the client config example, the canonical MCP client shape is stdio. No required API keys are documented.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README shows an MCP config snippet using stdio with `npx ruv-swarm mcp start`, even though examples also mention `--port 3000` and WebSocket access at localhost. Per the client config example, the canonical MCP client shape is stdio. No required API keys are documented.
Tools (5)
init
Initialize a swarm with a chosen topology and size
spawn
Create a specialized agent
orchestrate
Run coordinated multi-agent workflows
hook
Run Claude Code task hooks such as pre-task and post-task
mcp start
Start the MCP server
Environment variables
MCP_ENABLEDrequiredEnables MCP server mode in the Docker containerPrerequisites
- • Node.js 14+
Packages
ruv-swarm
npmv1.0.19transport: stdio
Details
- Language
- Rust
- License
- MIT
- Released
- Sep 10, 2025
- Last commit
- Feb 9, 2026
- Registry name
- io.github.ruvnet/ruv-swarm
Categories
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
31.4k
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
14.4k
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
14.4k