Log inSubmit server
Claude Flow logo

Claude Flow

Exposes Ruflo’s agent orchestration, memory, routing, swarm, and coordination features through a local MCP server.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Claude Flow

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "claude-flow": {
      "command": "npx",
      "args": [
        "-y",
        "ruflo@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The claude-flow MCP server, now presented as Ruflo, connects MCP clients to an agent orchestration harness for Claude Code and Codex. It exposes tools for routing work, coordinating agent swarms, managing tasks, using persistent memory, and communicating across machines through federation. Install it with the Ruflo CLI and run it as a local stdio server, making it suitable for MCP-enabled coding assistants that need coordinated multi-agent workflows. Claude Code users can also install Ruflo plugins that add a console and runtime policy or routing features.

Use cases

  • Coordinate multiple coding agents on a shared project
  • Route development tasks through agent swarms
  • Reuse memory and successful patterns across sessions
  • Monitor swarms, events, missions, and project costs
  • Connect agents running on different machines

Key features

  • MCP tools for agent orchestration
  • Swarm coordination and task routing
  • Persistent memory with local vector retrieval
  • Federated communication across machines
  • Claude Code console and runtime plugins
  • Terminal UI for project and swarm monitoring

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

16/16 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · ruflo@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars79kStargazers on the source repository.
npm downloads222kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Claude Flow works

What claude-flow does

claude-flow is the earlier name and lineage of Ruflo, an agent meta-harness built around Claude Code and Codex. It places an orchestration layer between an AI coding client and the agents that perform work, providing task routing, swarm coordination, memory, scheduling, and execution controls.

The system is intended for projects where one model session is not enough to manage the work. Agents can be organized into coordinated swarms, while stored experience can be reused across sessions. Federation extends coordination to agents on other machines, with security guardrails intended for controlled enterprise environments.

How it works

The conceptual flow is the client or CLI, followed by Ruflo’s router, swarm, agents, memory layer, and configured language-model providers. Ruflo uses the MCP interface to make its orchestration functions available to an MCP-compatible client. The server runs locally through a stdio process rather than requiring a hosted MCP endpoint.

Ruflo can also operate through Claude Code plugins. The core plugin supplies foundational tools, the console provides an agent cockpit, and the mods package adds routing and policy enforcement inside Claude Code. The optional terminal UI can run independently of Claude Code and displays project, cost, swarm, event, and mission information.

Memory and learning features include local vector retrieval and trajectory-based feedback mechanisms. Local retrieval and contrastive updates can run without an LLM, although embeddings and configured learning components are still needed for those workflows.

Setup and configuration

For a standard MCP client, initialize Ruflo in the project directory with:

Terminal
npx ruflo@latest init wizard

Configure the client with npx as the command and [-y, ruflo@latest, mcp, start] as its arguments. The equivalent command is:

Terminal
npx -y ruflo@latest mcp start

Claude Code users can instead add the Ruflo marketplace and install the core, console, and mods plugins, then reload plugins and launch the Ruflo interface. The documented Claude Code path requires Claude Code 2.1.287 or later. Mods execute with the permissions of the user account, so their code should be reviewed before installation.

An optional standalone terminal interface is available with npx ruflo tui; adding --plain prints one frame for script-oriented use.

Tools and capabilities

The MCP surface provides access to capabilities including:

  • Agent and swarm coordination
  • Task routing and scheduling
  • Persistent memory and local vector retrieval
  • Inter-agent communication and federation
  • Execution monitoring through the console or terminal UI
  • Policy enforcement and runtime routing in Claude Code
  • Learning from task outcomes and successful patterns

After initialization, the hooks system can route tasks, reuse learned patterns, and coordinate agents while the developer continues to work through Claude Code normally.

Limitations and notes

Ruflo’s console and mods are Claude Code integrations; MCP support alone does not provide those plugin-specific features. Hook behavior depends on the client. Federation is intended for communication between machines and should be evaluated alongside the project’s security requirements.

The server exposes a broad tool surface, but users do not need to learn every tool to begin. The standard entry point is the initialization wizard followed by normal use through the configured MCP client. Agent execution may still require an LLM even when local retrieval or contrastive learning runs locally.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Claude Flow

claude-flow is an MCP server that connects MCP clients to the Ruflo agent orchestration harness for Claude Code and Codex. Its main tools cover task routing, agent and swarm coordination, memory, scheduling, federation, and execution monitoring, allowing coding assistants to organize multi-agent workflows through a local stdio process.

Install it by running `npx ruflo@latest init wizard` in the project, then configure the client to launch `npx -y ruflo@latest mcp start`. For a local stdio configuration, use `npx` as the command and `-y`, `ruflo@latest`, `mcp`, and `start` as the arguments.

Yes, it can work with Cursor when Cursor is configured to run local stdio MCP servers. Use the Ruflo command `npx -y ruflo@latest mcp start`; Claude Code-specific plugins such as the console and mods are separate integrations.

Yes, Ruflo is designed to work with Codex through its MCP server. Initialize the project with the Ruflo wizard, then connect Codex to the local stdio command so it can access the orchestration tools.

Yes, its federation capability supports communication between agents on different machines. Federation is part of the orchestration model and should be configured with the project’s security and data-handling requirements in mind.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewClaude Flow AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/claude-flow?style=directory)](https://allmcps.com/mcp/claude-flow)
HTML Embed
<a href="https://allmcps.com/mcp/claude-flow"><img src="https://allmcps.com/api/badge/claude-flow?style=directory" alt="Claude Flow on AllMCPs" /></a>