# 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

## 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

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

2. Install editable package

```bash
pip install -e .
```

3. Run demo

```bash
python examples/run_demo.py
```

## Notes

- Current version is an MVP scaffold.
- Next iteration will add tool permission policy, async workers, and persistence.