Metadata-Version: 2.4
Name: morpheus-mcp
Version: 0.1.0
Summary: Plan state management and phase gate enforcement for AI dev loops via MCP
Project-URL: Homepage, https://github.com/evo-hydra/morpheus-mcp
Project-URL: Repository, https://github.com/evo-hydra/morpheus-mcp
Project-URL: Issues, https://github.com/evo-hydra/morpheus-mcp/issues
Author-email: EvoIntel <evo.nirvana@gmail.com>
License: MIT
Keywords: ai,dev-loop,gate-enforcement,mcp,orchestrator,plan-management
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: mcp<2.0,>=1.0
Requires-Dist: rich>=13
Requires-Dist: tomli>=2.0; python_version < '3.11'
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# morpheus-mcp

Plan state management and phase gate enforcement for AI dev loops via MCP. Morpheus tracks plan progress, enforces phase gates with evidence requirements, and coordinates task lifecycle across agents.

Part of the [EvoIntel](https://github.com/evo-hydra) suite: Sentinel, Seraph, Niobe, Merovingian, Morpheus, Anno.

## Install

```bash
pipx install morpheus-mcp
```

## MCP Tools

| Tool | Description |
|------|-------------|
| `morpheus_init` | Load a plan file, parse tasks, begin tracking |
| `morpheus_status` | Plan progress, task states, active phase |
| `morpheus_advance` | Advance a task through a phase gate with evidence |
| `morpheus_close` | Mark a plan as completed |

## Phase Gates

Each phase requires evidence before advancing:

| Phase | Required Evidence |
|-------|-------------------|
| CHECK | *(none)* |
| CODE | `fdmc_preflight` with 4 lenses (consistent must include `sibling_read`) |
| TEST | `build_verified` |
| GRADE | `tests_passed` |
| COMMIT | `seraph_id` (skipped if plan has `grade: false`) |
| ADVANCE | `knowledge_gate` |

## CLI

```bash
morpheus init plans/my-plan.md    # Load a plan
morpheus status                   # Show progress
morpheus advance <task-id> CHECK  # Advance a phase
morpheus close <plan-id>          # Close the plan
morpheus list                     # List all plans
```

## MCP Configuration

Add to your `.mcp.json` or `~/.claude.json`:

```json
{
  "mcpServers": {
    "morpheus": {
      "command": "morpheus-mcp",
      "args": []
    }
  }
}
```

## License

MIT
