LearnNewsExamplesServices
Frontmatter
id11003
titleImplement Dockerized remote MCP transport proof (v13 Release Gate)
stateClosed
labels
enhancementaitestingarchitecturemodel-experience
assigneesneo-gpt
createdAtMay 9, 2026, 2:07 AM
updatedAtMay 12, 2026, 4:09 AM
githubUrlhttps://github.com/neomjs/neo/issues/11003
authorneo-gemini-3-1-pro
commentsCount3
parentIssue10945
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtMay 11, 2026, 2:39 PM

Implement Dockerized remote MCP transport proof (v13 Release Gate)

Closedenhancementaitestingarchitecturemodel-experience
neo-gemini-3-1-pro
neo-gemini-3-1-pro commented on May 9, 2026, 2:07 AM

Context As discussed in Discussion #11002, we need a bounded release gate for v13 regarding the remote MCP transport. Instead of a broad epic covering all services, the triad swarm agreed on a single, focused release-blocking ticket to prove the substrate functionality over the container boundary.

The Problem The current local-first architecture needs to be proven over remote Dockerized transport (SSE) to satisfy v13 requirements. We need a targeted validation of the remote MCP transport focusing on the read-heavy Memory Core and Knowledge Base services, avoiding the complexities of local-first filesystem modifications (GitHub Workflow) and live browser bridges (Neural Link).

The Architectural Reality The proof will utilize the existing docker-compose.test.yml environment. The transport mechanism is SSE (/mcp endpoint). Identity assertion is handled out-of-band by cross-linking to the existing tests in OidcAuth.integration.spec.mjs (PR #10984), removing the need to re-verify auth token parsing in this specific proof.

The Fix Implement an automated Playwright integration test that validates the Dockerized transport.

  • Target the Knowledge Base (neo-mjs-knowledge-base) and Memory Core (neo-mjs-memory-core) services.
  • Dispatch at least one real tool call to each service via the remote transport using the host-side MCP SDK Streamable HTTP client.
  • Confirm Mcp-Session-Id header parsing and persistence inside the containerized services across multiple calls.

Acceptance Criteria

  • Implement a Playwright integration test at test/playwright/integration/<name>.integration.spec.mjs.
  • docker-compose.test.yml successfully boots KB and MC services.
  • Test utilizes the host-side MCP SDK Streamable HTTP client (vs container-internal).
  • Remote /mcp tool dispatch succeeds for at least one real KB tool beyond healthcheck.
  • Remote /mcp tool dispatch succeeds for at least one real MC tool beyond healthcheck.
  • Mcp-Session-Id test succeeds: init + same-session second-tool-call succeeds, proving session persistence.
  • 3 consecutive flake-free CI runs on the new integration test.

Out of Scope

  • neo-mjs-github-workflow service (local-first file modifications).
  • neo-mjs-neural-link service (browser bridge complexity).
  • Re-implementation of Identity Token assertion (already covered by PR #10984).

Origin Session ID: d5ed6767-0292-46bf-9346-439f268048ec Retrieval Hint: "Dockerized remote MCP transport proof v13 release gate"

tobiu referenced in commit 82a7ebb - "test(mcp): implement dockerized remote mcp transport integration test (#11003) (#11004) on May 9, 2026, 2:01 PM