Claude Army MCP server

🪖 ClaudeArmy

An MCP server that lets Claude orchestrate multiple Claude Code agents working autonomously across different projects.

What It Does

ClaudeArmy gives Claude (in the chat interface) the ability to spawn background Claude Code processes that work independently on coding tasks. Think of it as a chain of command:

• You → give strategic direction
• Claude (chat) → breaks it down and dispatches agents
• Claude Code agents → execute autonomously, spawning their own sub-agents as needed

This means you can kick off work across multiple projects simultaneously, keep chatting normally, and check in on progress whenever you want.

Tools

Setup

1. Clone this repo
2. npm install
3. Add to your Claude Desktop config:

• Linux: ~/.config/Claude/claudedesktopconfig.json
• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

"claude-army": {
  "command": "node",
  "args": ["/path/to/claude-army/src/index.js"]
}

Windows note: Use forward slashes in the path value (e.g. "C:/Users/you/claude-army/src/index.js").

1. Restart Claude Desktop

Usage Examples

Single project task:

"Refactor GarbageFire's app.py into modular components"

Multi-project parallel work:

"Refactor GarbageFire to be more modular, and add a Salesforce adapter to my Reporting Tool"

Claude will dispatch separate agents to each project directory and let them work autonomously.

Check progress:

"How are the agents doing?"

Agent Teams

Use mode: "team" on dispatch_task to have the lead agent automatically decompose work and spawn specialized sub-agents that run in parallel.

How it works:

• The lead agent analyzes the task and breaks it into focused subtasks
• Each subtask is delegated to a sub-agent via Claude Code's Task tool
• Sub-agents work in parallel, each with a well-defined scope
• The lead agent synthesizes results once all sub-agents complete

Monitoring teams:

• check_tasks shows a sub-agent summary (e.g. "3 sub-agents: 1 running, 2 completed")
• getagentteam gives a detailed tree view of the lead agent and every sub-agent, including status, runtime, and output previews

Configuration

Edit the constants at the top of src/index.js:

• CLAUDE_BINARY - Path to your Claude Code binary
• MAXCONCURRENTTASKS - Max simultaneous agents (default: 5)

Requirements

• Claude Code installed and authenticated
• Node.js 18+
• Claude Desktop or any MCP-compatible client

Changelog

v0.4.1

• Bump @modelcontextprotocol/sdk to ^1.26.0, resolving 3 high severity supply chain vulnerabilities
• Add repository field to package.json

v0.4.0

• Agent team support: track sub-agents spawned via Claude Code Task tool
• New getagentteam tool: tree view of lead + all sub-agents
• check_tasks now shows sub-agent summary for team operations
• dispatch_task gains mode parameter: solo (default) or team
• Cross-platform: fixed Windows binary (claude.cmd) and signal handling
• Error messages now show platform-appropriate diagnostic commands
• README: added setup paths for Linux, macOS, and Windows

Shortened. The full README is on GitHub.