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.1.tar.gz (49.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.1-py3-none-any.whl (33.6 kB view details)

Uploaded Python 3

File details

Details for the file morpheus_mcp-0.3.1.tar.gz.

File metadata

  • Download URL: morpheus_mcp-0.3.1.tar.gz
  • Upload date:
  • Size: 49.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.1.tar.gz
Algorithm Hash digest
SHA256 6d3a5208632a6821876bf98cf21c0faacba0231ac32c8237d123c6cfac71df35
MD5 f973583d3dcfdd510d9333b95b92a126
BLAKE2b-256 f6f55810e644a6b22a9d48f133735867862ab7c49ca407ff511fac2ae4bfa4b4

See more details on using hashes here.

File details

Details for the file morpheus_mcp-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: morpheus_mcp-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 33.6 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 124934f9437bf1e733edcc3b60118b9bf5bb4fd35777785e20377e867f79baf6
MD5 3d23473739f0cd8d25be1d0f4e662cb6
BLAKE2b-256 b86f3bd9ede2fb070666c17874e7ab30479634a1a612055bffa41169efaeb80d

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