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)

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)

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:

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