Skip to content

feat(eve): add MCP channel - #1377

Open
allenzhou101 wants to merge 15 commits into
mainfrom
allenzhou/mcp-agent-channel-implementation
Open

feat(eve): add MCP channel#1377
allenzhou101 wants to merge 15 commits into
mainfrom
allenzhou/mcp-agent-channel-implementation

Conversation

@allenzhou101

@allenzhou101 allenzhou101 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

What this implements

  • adds mcpChannel({ auth }) as a stateless MCP endpoint
  • serves MCP 2026-07-28 through the official @modelcontextprotocol/server v2 handler
  • keeps the SDK v2 stateless fallback for 2025-11-25 Streamable HTTP clients
  • enforces the required MCP-Protocol-Version header for modern POSTs while preserving earlier SDK validation errors
  • reuses existing inbound eve auth strategies directly
  • distinguishes missing Bearer credentials from rejected tokens (invalid_token) after the complete auth walk
  • adds generic oauthResource(auth, metadata) discovery policy under eve/channels/auth
  • serves protected-resource metadata over public CORS-enabled GET, HEAD, and OPTIONS routes while keeping /mcp exact same-origin
  • exposes agent_start, agent_get, agent_update, and agent_cancel over one durable task-mode invocation service
  • binds every invocation operation to the authenticated principal that created it
  • documents the end-user flow, OAuth resource-server boundary, CIMD ownership, and deferred MCP Tasks adapter

This does not depend on mcp-handler; eve vendors the official server SDK through its compiled dependency pipeline and owns the channel/auth integration.

Validation

  • formatting check and targeted oxlint
  • pnpm docs:check
  • pnpm --filter eve typecheck
  • full eve unit suite: 532 files, 5,618 passed, 1 skipped
  • pnpm --filter eve build
  • local test-agent linked to this package: typecheck + production build
  • live HTTP checks for PRM cross-origin GET/HEAD/OPTIONS, missing credentials, invalid_token, missing protocol header (400/-32020), and successful server/discover
  • real local agent: server/discover, tools/list, agent_start, and agent_get completed with hardened MCP works
  • raw MCP 2025-11-25 stateless initialize fallback remains covered

Deferred

  • MCP Tasks capability negotiation
  • conversation continuation / agent_send
  • direct authored capability export
  • provider-specific OAuth servers

Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eve-docs Ready Ready Preview Jul 30, 2026 6:38pm
eve-docs-4759 Ready Ready Preview, v0 Jul 30, 2026 6:38pm

@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Bundle + Package Summary: apps/fixtures/weather-agent

Key takeaways

  • Package delta: install footprint 91.28 MB -> 91.75 MB (+473.9 kB ⚠️).

Delta vs main (255027e)

Area Metric Baseline Current Delta
Package Packed tarball 7.62 MB 7.75 MB +125.8 kB ⚠️
Package Unpacked publish size 28.80 MB 29.28 MB +473.9 kB ⚠️
Package Installed footprint 91.28 MB 91.75 MB +473.9 kB ⚠️
Package Published files 2876 2894 +18
Package Installed files 6665 6683 +18
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 16.81 MB 16.81 MB +1.4 kB ⚠️
Runtime Public routes 11 11 0
Changed function payloads vs main (255027e) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.41 MB 8.41 MB +717 B ⚠️ none
functions/.well-known/workflow/v1/flow.func changed 8.41 MB 8.41 MB +717 B ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 129.68 MB 130.15 MB +473.9 kB ⚠️
Installed packages 128 128 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 43.14 MB 43.61 MB +473.9 kB ⚠️
devDependency package bytes 5.04 MB 5.04 MB 0 B ➖
Build Metadata
  • Preset: vercel
  • Nitro: nitro@3.0.260610-beta
  • Output directory: apps/fixtures/weather-agent/.vercel/output
  • Build metadata timestamp: 2026-07-30T18:40:07.613Z
  • Route aliases: 11 public, 1 internal (12 total aliases)
  • Vercel routes in config: 14
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.28.0
  • Package directory: packages/eve
  • Tarball: 7.75 MB (eve-0.28.0.tgz)
  • Unpacked payload: 29.28 MB across 2894 published files
  • Installed footprint: 91.75 MB across 6683 installed files
  • Installed root package: 27.92 MB
  • Installed dependencies: 63.83 MB
  • Runtime dependencies: 2
  • Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.

Heavy installed dependencies

  • eve: 27.92 MB (30.4%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (21.0%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (11.6%)
  • @napi-rs/wasm-runtime: 6.56 MB (7.2%)
  • ai: 6.53 MB (7.1%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [########################] 13.15 MB 44.9%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 5.1%
🟡 dist/src/compiled/@vercel/sandbox/index.js       [#.......................] 632.5 kB 2.2%
🟡 dist/src/compiled/_chunks/workflow/undici-DWL... [#.......................] 502.4 kB 1.7%
🟡 dist/src/compiled/@chat-adapter/slack/index.js   [#.......................] 440.5 kB 1.5%
🔴 Other published files                            [########################] 13.04 MB 44.5%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.92 MB 30.4%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 19.28 MB 21.0%
🔴 @rolldown/binding-wasm32-wasi   [#########...............] 10.66 MB 11.6%
🔴 @napi-rs/wasm-runtime           [######..................] 6.56 MB 7.2%
🔴 ai                              [######..................] 6.53 MB 7.1%
🔴 zod                             [####....................] 5.07 MB 5.5%
🔴 Other installed packages        [##############..........] 15.73 MB 17.1%
Runtime dependencies (2)
Package Range Notes
nitro 3.0.260610-beta
undici 8.9.0
Peer dependencies (5)
Package Range Notes
@opentelemetry/api ^1.0.0 optional peer
ai catalog:
braintrust ^3.0.0 optional peer
just-bash ^3.0.0 optional peer
microsandbox ^0.5.0 optional peer
eve init install drill-down

eve init install details

  • Command: eve init my-agent
  • Package manager: npm
  • Installed footprint: 130.15 MB across 8551 installed files
  • Installed packages: 128 total (122 transitive-only)
  • dependencies: 4 direct packages totaling 43.61 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 81.50 MB

Installed footprint is measured from an isolated temporary eve init my-agent using the current packed eve tarball.

Heavy installed dependencies

  • @typescript/typescript-linux-x64: 27.95 MB (21.5%)
  • eve: 27.92 MB (21.5%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (14.8%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (8.2%)
  • zod: 9.02 MB (6.9%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 21.5%
🔴 eve                              [########################] 27.92 MB 21.5%
🔴 @rolldown/binding-linux-x64-gnu  [#################.......] 19.28 MB 14.8%
🔴 @rolldown/binding-wasm32-wasi    [#########...............] 10.66 MB 8.2%
🔴 zod                              [########................] 9.02 MB 6.9%
🔴 @napi-rs/wasm-runtime            [######..................] 6.56 MB 5.0%
🔴 ai                               [######..................] 6.53 MB 5.0%
🔴 Other installed packages         [###################.....] 22.23 MB 17.1%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.2 135.8 kB 0.1%
ai ^7.0.38 6.53 MB 5.0%
eve file:eve-0.28.0.tgz 27.92 MB 21.5%
zod 4.4.3 9.02 MB 6.9%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.0%
typescript 7.0.2 2.50 MB 1.9%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 8.41 MB 50.0%
🔴 functions/__server.func                         [########################] 8.41 MB 50.0%

Top Function Payloads

🟠 functions/.well-known/workflow/v1/flow.func • 1 public route • 8.41 MB
Metric Value
Public routes /.well-known/workflow/v1/flow
Runtime nodejs24.x
Handler index.mjs
Payload 8.41 MB
Function files 8.41 MB across 43 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.31 MB (27.5%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [########################] 2.31 MB 27.5%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.59 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.7%
🟡 _chunks/sandbox.mjs             [########................] 768.8 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.32 MB 27.6%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x",
  "maxDuration": "max",
  "experimentalTriggers": [
    {
      "type": "queue/v2beta",
      "topic": "__eve776561746865722d6167656e74_wkf_workflow_*",
      "consumer": "default",
      "retryAfterSeconds": 5,
      "initialDelaySeconds": 0
    }
  ],
  "environment": {
    "WORKFLOW_PRECONDITION_GUARD": "1"
  }
}

🟠 functions/__server.func • 10 public routes, 1 internal alias • 8.41 MB
Metric Value
Public routes /
/eve/v1/callback/[token]
/eve/v1/connections/[name]/callback/[token]
/eve/v1/health
/eve/v1/info
/eve/v1/session
/eve/v1/session/[sessionId]
/eve/v1/session/[sessionId]/cancel
/eve/v1/session/[sessionId]/stream
/eve/v1/session/reset
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 8.41 MB
Function files 8.41 MB across 43 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.31 MB (27.5%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [########################] 2.31 MB 27.5%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.59 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.7%
🟡 _chunks/sandbox.mjs             [########................] 768.8 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.32 MB 27.6%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x"
}

Build Timing: e2e/fixtures/agent-tools-sandbox

This is an informational timing measurement inside eve build, from preflight through publication. Output-size measurement and profile writing are excluded.

Build mode: deployable Vercel build with sandbox template prewarm included.

  • Build pipeline: 1.62 s -> 1.75 s (+132.0 ms) vs main (255027e).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (255027e)`
Phase Baseline Current Delta
extension.check 6.2 ms 8.9 ms +2.7 ms
project.resolve 6.0 ms 3.3 ms -2.7 ms
workspace.create 1.2 ms 1.0 ms -0.2 ms
host.prepare 171.2 ms 129.6 ms -41.6 ms
vercel.service-prefix.resolve 1.5 ms 1.5 ms 0.0 ms
nitro.create 150.3 ms 152.7 ms +2.4 ms
sandbox.prewarm 221.6 ms 267.3 ms +45.7 ms
nitro.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.prepare 0.6 ms 0.5 ms -0.1 ms
nitro.public-assets 0.6 ms 0.6 ms 0.0 ms
nitro.prerender 0.3 ms 0.3 ms 0.0 ms
nitro.bundle 991.5 ms 1.14 s +151.9 ms
nitro.cache.write 0.2 ms 0.3 ms +0.1 ms
vercel.workflow-function.materialize 63.8 ms 39.3 ms -24.5 ms
agent-summary.emit 0.5 ms 0.4 ms -0.1 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 4.2 ms 2.5 ms -1.7 ms
workspace.remove 1.5 ms 1.4 ms -0.1 ms

Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@socket-security

socket-security Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addednpm/​@​modelcontextprotocol/​server@​2.0.0801008597100

View full report

Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@allenzhou101
allenzhou101 force-pushed the allenzhou/mcp-agent-channel-implementation branch from b49e9a8 to 0f61a9b Compare July 30, 2026 00:05
@vercel
vercel Bot temporarily deployed to Preview – eve-docs-4759 July 30, 2026 00:05 Inactive
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@allenzhou101
allenzhou101 force-pushed the allenzhou/mcp-agent-channel-implementation branch from b116754 to 9ed296d Compare July 30, 2026 17:07
@allenzhou101
allenzhou101 marked this pull request as ready for review July 30, 2026 17:39
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>

# Conflicts:
#	packages/eve/src/execution/workflow-runtime.ts
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@allenzhou101
allenzhou101 force-pushed the allenzhou/mcp-agent-channel-implementation branch from e0fe4b7 to 8992fee Compare July 30, 2026 17:59
@vercel
vercel Bot temporarily deployed to Preview – eve-docs-4759 July 30, 2026 17:59 Inactive
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
Signed-off-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@allenzhou101
allenzhou101 marked this pull request as ready for review July 30, 2026 18:38
@allenzhou101 allenzhou101 changed the title feat(eve): add durable MCP agent channel feat(eve): add MCP channel Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants