Skip to main content

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.

github.com/evo-hydra

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

morpheus_mcp-0.3.0.tar.gz (51.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

morpheus_mcp-0.3.0-py3-none-any.whl (32.2 kB view details)

Uploaded Python 3

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

Hashes for morpheus_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 20ec3a4d2ef182ed7e87166911c0d8c4721095444aae7aa6989e6099262cd235
MD5 131671e05754448a07d7366cdd5981fe
BLAKE2b-256 a5d88eb2e598ef6edfed25834caa9fef12e35e7482c684217216038ebe8d166c

See more details on using hashes here.

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

Hashes for morpheus_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 430d44d2c7d0942cb9264ba1211cd8bf53bd1d3bee94b29ffd11ab29bddecfe1
MD5 2c89af7d552ad02b8f521b4ff471825d
BLAKE2b-256 9163e241c8315bd9651f0dcf614a4cd59a052633ce0c64ee4b970e81fc17588b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page