Skip to content

Phase 1: MCP design, contracts, and ADR #1293

Closed

Description

@neuromechanist

Part of epic #1065. Settle the design before any route exists: the Streamable HTTP library on Workers (Hono MCP middleware over the official TypeScript SDK in stateless mode, versus Cloudflare's agents package, which is Durable-Object stateful and conflicts with the broker decision in ADR 0049), index caching through the zarr gateway's existing edge cache, the recipe and provenance envelope shapes as zod contracts in shared/contract aligned with the layout constants in shared/zarr-index.schema.json, events.parquet range reads with an events.tsv fallback, PNG encoding for render_overview, anonymous access on the existing rate-limit buckets, and the per-call Analytics Engine data point shape.

Definition of done: .context/mcp-server-design.md, contract types with schema tests, and ADR 0050 recording the transport and access decisions. If dev does not yet carry ADR 0049 when this PR is ready, the ADR file moves to phase 5 and the decision text stays in the design doc.

Activity

  1. neuromechanist commented on Sep 8, 2026

    @neuromechanist
    ContributorAuthor

    Delivered by #1314, squash-merged into the epic branch feature/issue-1065-epic-mcp-server (a merge into a non-default branch does not auto-close). Design doc: .context/mcp-server-design.md. ADR 0050 is deferred to phase 5 (#1297) until #1292 lands on dev. The zod 4 bump blocker is tracked separately in #1316.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureNew feature or enhancement

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions