Cloudflare Workers adapter for Vurb.ts. Deploys your MCP server to the edge — stateless JSON-RPC, cold-start caching, native env injection, zero polyfills.

Quick Start

// src/index.ts (Cloudflare Worker)
import { createCloudflareHandler } from '@vurb/cloudflare';
import { registry } from './registry.js';

export default {
    async fetch(req: Request, env: Env): Promise<Response> {
        const handler = createCloudflareHandler(registry, {
            contextFactory: () => ({
                db: env.DB,
                kv: env.KV_STORE,
            }),
        });
        return handler(req);
    },
};

Features

| Feature | Description | |---------|-------------| | Zero Polyfills | Built for the WinterCG runtime, no Node.js shims | | Stateless JSON-RPC | Each request is a standalone invocation, ideal for edge | | Cold-Start Caching | Registry and Zod schemas compiled once per isolate | | Native Bindings | Access KV, D1, R2, and Durable Objects via context | | Wrangler Ready | Deploy with wrangler deploy |

With D1 Database

const handler = createCloudflareHandler(registry, {
    contextFactory: (env) => ({
        db: env.DB,          // D1 binding
        cache: env.KV_CACHE, // KV binding
        role: 'ADMIN',
    }),
});

Installation

npm install @vurb/cloudflare

Peer Dependencies

| Package | Version | |---------|---------| | vurb | ^2.0.0 | | @modelcontextprotocol/sdk | ^1.12.0 |

Requirements

• Cloudflare Workers (WinterCG runtime)
• Vurb.ts ≥ 2.0.0 (peer dependency)
• wrangler CLI for deployment

License

Apache-2.0