Plan state management and phase gate enforcement for AI dev loops via MCP
Project description
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 EvoIntel
Morpheus is one server in a suite designed to work together. Each handles a different concern in the AI development loop:
| Server | Role |
|---|---|
| Morpheus | Plan state & phase gate enforcement (you are here) |
| Sentinel | Persistent project intelligence — conventions, pitfalls, co-changes |
| Seraph | Verification intelligence for AI-generated code |
| Niobe | Runtime intelligence & log analysis |
| Merovingian | Cross-repo dependency tracking & contract management |
| Anno | Web content extraction via stealth browser |
Each server runs independently, but they reinforce each other. Morpheus orchestrates the dev loop. Sentinel and Seraph provide the intelligence Morpheus gates on. Niobe watches runtime. Merovingian tracks what breaks across repos.
Install
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
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:
{
"mcpServers": {
"morpheus": {
"command": "morpheus-mcp",
"args": []
}
}
}
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file morpheus_mcp-0.3.0.tar.gz.
File metadata
- Download URL: morpheus_mcp-0.3.0.tar.gz
- Upload date:
- Size: 51.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20ec3a4d2ef182ed7e87166911c0d8c4721095444aae7aa6989e6099262cd235
|
|
| MD5 |
131671e05754448a07d7366cdd5981fe
|
|
| BLAKE2b-256 |
a5d88eb2e598ef6edfed25834caa9fef12e35e7482c684217216038ebe8d166c
|
File details
Details for the file morpheus_mcp-0.3.0-py3-none-any.whl.
File metadata
- Download URL: morpheus_mcp-0.3.0-py3-none-any.whl
- Upload date:
- Size: 32.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
430d44d2c7d0942cb9264ba1211cd8bf53bd1d3bee94b29ffd11ab29bddecfe1
|
|
| MD5 |
2c89af7d552ad02b8f521b4ff471825d
|
|
| BLAKE2b-256 |
9163e241c8315bd9651f0dcf614a4cd59a052633ce0c64ee4b970e81fc17588b
|