chora-orchestration 0.3.1

MCP server orchestration CLI and HTTP server for managing Docker-based MCP services

chora-orchestration

MCP server orchestration CLI and HTTP server for managing Docker-based MCP services.

Features

• Dual Mode Operation: CLI commands + MCP HTTP server + stdio bridge
• Docker Integration: Manages containers via Docker SDK
• Smart Path Resolution: Auto-discovers registry.yaml with 5-tier fallback hierarchy
• Cross-Platform: Consistent behavior on Windows, Linux, and macOS
• Auto-Discovery: Reads registry.yaml for server definitions
• Health Monitoring: Tracks container and endpoint health
• Log Access: View container logs for debugging
• Gateway Proxying: Unified MCP endpoint exposing both orchestration and gateway tools

Installation

From PyPI (Recommended)

pip install chora-orchestration

Latest version: 0.2.0 (ready to publish)

What's new in 0.2.0:

• Smart path resolution with environment variable support (CHORA_REGISTRY_PATH)
• Cross-platform path handling with pathlib
• Home directory config support (~/.chora/registry.yaml)
• MCP stdio bridge for unified tool exposure
• 13 new comprehensive tests (74 total)

From Source (Development)

git clone https://github.com/liminalcommons/chora-orchestration.git
cd chora-orchestration
poetry install

Usage

CLI Mode

# Initialize ecosystem
chora-orch init

# Deploy server
chora-orch deploy n8n

# List servers
chora-orch list

# Check health
chora-orch health manifest

# View logs
chora-orch logs n8n --tail 50

# Stop server
chora-orch stop n8n

# Get status
chora-orch status

MCP Server Mode

# Start MCP HTTP server
chora-orch-serve --port 8090

Then access tools via HTTP:

• POST /tools/init
• POST /tools/deploy
• POST /tools/list
• POST /tools/health
• POST /tools/logs
• POST /tools/stop
• POST /tools/status

Development

# Run tests
poetry run pytest -v

# Run with coverage
poetry run pytest --cov=chora_mcp_orchestration --cov-report=term-missing

# Type check (if mypy added)
poetry run mypy src/

Documentation

• Requirements - Full specification
• Bootstrap Guide - Quick start with stdio bridge
• PyPI Publishing Guide - Publishing workflow
• CLI Scenarios - BDD scenarios
• MCP Server Scenarios - HTTP tool scenarios
• CHANGELOG - Version history

License

MIT