agent-orchestrator

# Agent Orchestrator (Production Multi-Strategy MCP) This repository provides **four production-oriented orchestration strategies**, each packaged as a separate MCP server so customers can choose the model that best fits their workload. ## Available MCP Servers 1. **Centralized Role Queue** - Best for predictable coordination and straightforward operations. - Entry point: `agent_orchestrator.mcp_centralized` 2. **Event-Sourced Blackboard** - Best for replay, auditability, and postmortem reconstruction. - Entry point: `agent_orchestrator.mcp_blackboard` 3. **Hierarchical Planner + Executors** - Best for long-horizon decomposition into DAGs. - Entry point: `agent_orchestrator.mcp_hierarchical` 4. **Market/Bidding Scheduler** - Best for heterogeneous agents with dynamic assignment. - Entry point: `agent_orchestrator.mcp_market` ## Quick Start ### Run servers (stdio MCP) ```bash PYTHONPATH=src python3 -m agent_orchestrator.mcp_centralized PYTHONPATH=src python3 -m agent_orchestrator.mcp_blackboard PYTHONPATH=src python3 -m agent_orchestrator.mcp_hierarchical PYTHONPATH=src python3 -m agent_orchestrator.mcp_market ``` ### Legacy HTTP server (centralized queue) ```bash PYTHONPATH=src python3 -m agent_orchestrator.server --host 127.0.0.1 --port 8787 ``` ## Step-by-step Production Plans Detailed implementation guidance for your idea and three alternatives is in: - `docs/IMPLEMENTATION_PLAYBOOK.md` That playbook includes: - deployment steps for each model - controls for reliability, security, and observability - model selection guidance ## Tests Scenario-specific tests are included for every orchestration strategy and MCP layer: - `tests/test_centralized.py` - `tests/test_store.py` - `tests/test_blackboard.py` - `tests/test_hierarchical.py` - `tests/test_market.py` - `tests/test_mcp_servers.py` Run all tests: ```bash PYTHONPATH=src python3 -m unittest discover -s tests -v ``` ## Package Scripts `pyproject.toml` exposes executable scripts: - `agent-orchestrator-http` - `agent-orchestrator-mcp-centralized` - `agent-orchestrator-mcp-blackboard` - `agent-orchestrator-mcp-hierarchical` - `agent-orchestrator-mcp-market`