mcp_supervisor_py

Python-first scaffold for an MCP-style supervisor role.

Goal

Build a supervisor that can:

• accept a user task

• break it into steps

• route steps to workers

• retry on transient failures

• aggregate final output

• emit structured logs for auditability

Related MCP server: hotwired-mcp

Reference repositories

This repository is intended to be designed with ideas inspired by:

• https://github.com/chenjordan/yt_agent

• https://github.com/chenjordan/new_summary

Project layout

• src/mcp_supervisor/config.py: runtime configuration

• src/mcp_supervisor/supervisor.py: supervisor core logic

• src/mcp_supervisor/init.py: package exports

• examples/run_demo.py: runnable demonstration

Quick start

1. Create a virtual environment

python -m venv .venv
.venv\Scripts\activate

2. Install editable package

pip install -e .

3. Run demo

python examples/run_demo.py

Notes

• Current version is an MVP scaffold.

• Next iteration will add tool permission policy, async workers, and persistence.