Claude-code MCP server that uses THoT meta orchestration for fractal agent spawning - A comprehensive tool orchestration system that manages complex workflows through structured phases and 65+ API registry integration.
Watch the complete walkthrough - See the 6-phase workflow orchestration in real-time
Iron Manus MCP is a comprehensive FSM-driven orchestration system that manages complex workflows through structured phases. It features a complete tool registry with JARVIS FSM controller and intelligent API selection from 65+ endpoints.
6-Phase Workflow: QUERY → ENHANCE → KNOWLEDGE → PLAN → EXECUTE → VERIFY
Key Features:
- 🔄 6-Phase FSM Loop - Structured workflow orchestration with INIT/DONE states
- 🛠️ Modular Tool Registry - Extensible architecture with 5+ specialized tools
- 📡 65+ API Registry - Intelligent API discovery and selection system
- 🔒 SSRF Protection - Enterprise-grade security with allowlist validation
- ✅ 107/107 Tests Passing - Comprehensive test coverage with Vitest
- 📦 ES Modules - Modern JavaScript with TypeScript 5.0 support
# Clone and install
git clone https://github.com/dnnyngyen/iron-manus-mcp
cd iron-manus-mcp
npm install
# Build TypeScript
npm run build
# Run tests (optional)
npm test
# Start server
npm startFor MCP Integration: Add to your MCP client configuration or register with Claude Code:
claude mcp add iron-manus-mcp node dist/index.jsInput:
await mcp.callTool({
name: 'JARVIS',
args: {
session_id: 'demo',
initial_objective: 'Build a TypeScript API with tests'
}
});6-Phase Flow:
- QUERY - Analyze request and detect role
- ENHANCE - Add missing requirements and context
- KNOWLEDGE - Auto-discover relevant APIs and patterns
- PLAN - Create structured tasks with meta-prompts
- EXECUTE - Process tasks with specialized tools
- VERIFY - Validate completion and quality
JARVIS- Main FSM controller (6-phase orchestration)APISearch- Intelligent API discovery from 65+ endpoint registryMultiAPIFetch- Parallel HTTP requests with SSRF protectionKnowledgeSynthesize- Cross-validation with conflict resolutionAPIValidator- Response validation and confidence scoring
Prerequisites:
- Node.js 18+ (tested with 18.x, 20.x, 22.x)
- npm 8+
- TypeScript 5.0+
Available Scripts:
npm run build # TypeScript compilation
npm test # Run full test suite (107 tests)
npm run test:nocov # Run tests without coverage
npm run lint # ESLint checking
npm run format # Prettier formatting
npm start # Start compiled server
npm run dev # Build and start serverConfiguration: Environment variables for customization:
KNOWLEDGE_MAX_CONCURRENCY=2 # API concurrency limit
KNOWLEDGE_TIMEOUT_MS=4000 # Request timeout
ALLOWED_HOSTS="api.github.com,httpbin.org" # SSRF whitelist
ENABLE_SSRF_PROTECTION=true # Security toggle
MIN_COMPLETION_PERCENT=70 # Quality thresholdComprehensive test suite with 107 tests using Vitest:
# Run all tests
npm test
# Run tests without coverage
npm run test:nocov
# Run specific test types
npm run test:unit
npm run test:integration
npm run test:e2eTest Coverage:
- Configuration management
- SSRF protection and security
- FSM state transitions
- Tool integrations
- API registry functionality
- Server initialization and MCP compliance
Enterprise-grade SSRF protection built-in:
- Blocks private/localhost IPs (192.168.x.x, 127.x.x.x, etc.)
- Validates URL schemes (HTTP/HTTPS only)
- Enforces allowlist when configured
- Request timeout and size limits
- Rate limiting per API endpoint
Core Components:
- FSM Engine - 6-phase state machine orchestration
- Tool Registry - Modular tool architecture with dependency injection
- API Registry - 65+ APIs with role-based selection
- Security Layer - SSRF guard with comprehensive validation
- Type System - Full TypeScript interfaces and schemas
MIT - See LICENSE file for details.
- v0.2.0 - Complete refactor with Jest→Vitest migration, repository flattening, 6-phase FSM
- v0.1.x - Initial release with 6-phase workflow
Built for modern AI orchestration - Structured workflows meet intelligent automation.
