MCP Server

CervellaSwarm MCP Server

The only AI coding team that checks its own work.

17 AI agents with quality guardians for Claude Code.

Quick Start

1. Install

npm install -g @cervellaswarm/mcp-server

2. Configure Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "cervellaswarm": {
      "command": "cervellaswarm-mcp"
    }
  }
}

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "cervellaswarm": {
      "command": "cervellaswarm-mcp"
    }
  }
}

3. Set API Key

Install the CLI and run init:

npm install -g cervellaswarm
cervellaswarm init

Or set environment variable directly:

export ANTHROPIC_API_KEY=sk-ant-...

4. Restart Claude Code

Restart Claude Code to load the MCP server. You'll have access to these tools:

• spawn_worker: Execute tasks with specialized AI workers
• list_workers: See available workers and their specialties
• check_status: Verify configuration and API key
• check_usage: Check your usage quota

Available Agents (17)

Models: Regina/Guardiane/Architect use Opus 4.5, Workers use Sonnet 4.5

The Architect (1) - Strategic Planner [OPUS]

Guardiane (3) - Quality Gates [OPUS]

Regina (1) [OPUS]

Workers (12) [SONNET]

Example Usage in Claude Code

Use spawn_worker to create a REST API endpoint for user authentication

Claude Code will call the spawn_worker tool with worker: "backend" automatically.

Development (for contributors)

# Clone and install
git clone https://github.com/rafapra3008/CervellaSwarm
cd cervellaswarm/packages/mcp-server
npm install

# Watch mode
npm run dev

# Test with MCP Inspector
npm run inspect

# Build
npm run build

Local Development Config

For local development, use path-based config in ~/.claude/settings.json:

{
  "mcpServers": {
    "cervellaswarm": {
      "command": "node",
      "args": ["/path/to/CervellaSwarm/packages/mcp-server/dist/index.js"]
    }
  }
}

Architecture

MCP Server
    │
    ├── Tools
    │   ├── spawn_worker    → Anthropic API (your key)
    │   ├── list_workers    → Static list
    │   ├── check_status    → Config check
    │   └── check_usage     → Quota info
    │
    └── Shares config with CLI
        └── Uses same API key from cervellaswarm init

Philosophy

"Sometimes it feels like magic."

We're honest: AI tools aren't perfect. Context gets lost, mistakes happen. Our solution? Built-in quality guardians - three dedicated agents whose job is to review and verify the work of others.

Not promising perfection. Promising honesty and continuous improvement.

Links

• CLI: cervellaswarm on npm
• GitHub: rafapra3008/CervellaSwarm

"17 agents with quality guardians. Your AI team in Claude Code."