ari1110/cns-mcp-server

CNS MCP Server

Autonomous Multi-Agent Orchestration for Claude Code

Transform Claude Code from a single agent into an autonomous multi-agent system that orchestrates complex workflows automatically.

🚀 Quick Start

# Install globally
npm install -g cns-mcp-server

# Initialize system  
cns-server init

# Add to Claude Code (copy the configuration shown)

That's it! CNS is now orchestrating your Claude Code workflows.

✨ What You Get

🤖 Autonomous Agent Orchestration

• Managers create specifications → CNS detects patterns → Associates implement → Managers review
• Zero manual intervention - workflows happen automatically
• Pattern recognition detects "Task Assignment", "Implementation Complete", "Approved for Integration"

🧠 Free Semantic Memory

• Zero API costs - uses Transformers.js locally
• Hybrid search - semantic + text matching
• 384-dimensional embeddings with automatic storage

🏗️ Workspace Isolation

• Git worktrees for parallel development
• Branch-based isolation per workflow
• Automatic cleanup after completion

🎛️ Slash Commands

Direct control in Claude Code conversations:

• /cns:status - System overview
• /cns:health - Health diagnostics
• /cns:workflows - Active workflows
• /cns:search <query> - Memory search
• /cns:memories - Recent memories
• /cns:help - Usage guide

📋 Installation

See for detailed setup instructions.

📚 Documentation

• - Setup and configuration
• - Workflow examples and best practices
• - Common issues and solutions

🎯 Example: Authentication System

You ask:

"Please implement a user authentication system"

CNS orchestrates automatically:

1. Manager creates specifications with JWT, bcrypt, session management
2. CNS detects "Task Assignment" → auto-launches Associate
3. Associate implements complete auth system with tests
4. CNS detects "Implementation Complete" → auto-launches Manager review
5. Manager approves with "Approved for Integration"
6. CNS completes workflow, stores knowledge, cleans workspace

Result: Production-ready authentication system delivered through autonomous agent coordination.

🔧 Requirements

• Node.js: 18.0.0 or higher
• RAM: 2GB available memory
• Storage: 500MB for models and data
• OS: Windows, macOS, or Linux

🏥 Health Check

cns-server validate

Expected output:

🔍 Validating CNS MCP Server Configuration...
✓ Configuration file exists
✓ Using free local Transformers.js embeddings  
✅ Validation complete!

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: GitHub Wiki

📄 License

MIT - see file.

Ready to transform your development workflow? Install CNS and watch autonomous agent orchestration in action! 🚀