[Phase 3] Unified MCP Core migration — work in progress

[n24q02m]

Status

Phase 3 "Unified MCP Core" migration is in active development. Contributors: please coordinate before opening PRs against main until Phase J lands.

What changes for mnemo-mcp

• Transport: stdio (uvx mnemo-mcp) → Streamable HTTP 2025-11-25 on local port 41602 + OAuth 2.1
• Delete src/mnemo_mcp/credential_state.py + tests/test_credential_state.py; remove inline AWAITING_SETUP gate from server.py (transport middleware handles 401)
• Migrate imports from archived mcp-relay-core → new mcp-core package (~120 refs)
• GDrive sync scope: drive.file → drive.appdata (src/mnemo_mcp/sync.py:43) — fixes duplicate folder issue
• Embedding: load model via new mcp-embedding-daemon (shared across wet/mnemo/crg)
• Graph backend confirmed: SQLite + sqlite-vec + SQL graph tables (not FalkorDB)
• Flip .claude-plugin/plugin.json from "command": "uvx" → "type": "http"
• Update docs/setup-with-agent.md + docs/setup-manual.md + README.md
• Tier A — local HTTP default, remote opt-in self-host only (heavy resources)
• Target version: 2.0.0

Design + plan

• Spec v3: https://github.com/n24q02m/claude-plugins/blob/feat/phase3-mcp-core-unified/docs/superpowers/specs/2026-04-10-mcp-core-unified-transport-design.md
• Doc update matrix: https://github.com/n24q02m/claude-plugins/blob/feat/phase3-mcp-core-unified/docs/superpowers/specs/2026-04-11-doc-update-matrix.md
• Phase G plan (unblock): https://github.com/n24q02m/claude-plugins/blob/feat/phase3-mcp-core-unified/docs/superpowers/plans/2026-04-11-phase-g-unblock.md
• Phase H plan (GDrive cleanup): https://github.com/n24q02m/claude-plugins/blob/feat/phase3-mcp-core-unified/docs/superpowers/plans/2026-04-11-phase-h-gdrive-cleanup.md
• Phase I plan (archive + bootstrap mcp-core): https://github.com/n24q02m/claude-plugins/blob/feat/phase3-mcp-core-unified/docs/superpowers/plans/2026-04-11-phase-i-archive-bootstrap.md
• Tracking branch: https://github.com/n24q02m/claude-plugins/tree/feat/phase3-mcp-core-unified

Timeline

• Phase G (unblock current CI + PR backlog): 2026-04-11 to 2026-04-14
• Phase H (GDrive cleanup): 2026-04-14 to 2026-04-16
• Phase I (archive mcp-relay-core + bootstrap mcp-core): 2026-04-16 to 2026-04-23
• Phase J (per-repo migration): 2026-04-23 to 2026-05-07
• Phase K/L/M (docs polish, PR cleanup, E2E): 2026-05-07 to 2026-05-15
• Stable release target: end of May 2026

Coordination ask

• Bot PRs (Renovate, Dependabot): welcome, batched into Phase G
• Human PRs: please open an issue first to discuss alignment with Phase 3 direction
• Breaking changes: major version bump at Phase J completion
• Pre-commit hook: fix: / feat: prefix only (enforced from 2026-04-10)
• No ! breaking indicator; use BREAKING CHANGE: footer instead