edge.libx.js 0.2.4 → 0.3.0

package/README.md

@@ -1,33 +1,108 @@
 # 🗡️ edge.libx.js
 
 Provider-agnostic, edge-compatible, [itty-router](https://itty.dev/itty-router/) microrouter wrapper. 
-Allowing you to crete multi-route endpoints that can work with Cloudflare, Vercel, Google Cloud Functions, Netlify Functions, and any other provider.
+Allowing you to create multi-route endpoints that can work with Cloudflare, Vercel, Google Cloud Functions, Netlify Functions, and any other provider.
 
 ## Get Started:
 
-```ts:
-import { Route, Router, RouterType, error, json, cors, text } from 'itty-router';
-import { RouterWrapper } from 'edge.libx.js';
+```ts
+import { RouterWrapper, cors } from 'edge.libx.js';
+import { json, error } from 'itty-router';
 
-const routerWrapper = RouterWrapper.getNew('/v1');
+// Create router with base path and optional CORS configuration
+const routerWrapper = RouterWrapper.getNew('/v1', {
+	origin: '*',
+	allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS', 'PATCH'],
+	allowHeaders: ['Content-Type', 'Authorization']
+});
+
+// Add routes
+routerWrapper.router.get('/ping', async (req) => {
+	return json({ message: 'pong', timestamp: Date.now() });
+});
 
-routerWrapper.router.all('/ping', async (req) => {
-	return json({ message: 'pong' });
+routerWrapper.router.post('/users', async (req) => {
+	const body = await req.json();
+	return json({ success: true, user: body });
 });
+
+// Catch unmatched routes
+routerWrapper.catchNotFound();
+
+// Export for edge runtime (Cloudflare Workers, Vercel Edge, etc.)
+export default {
+	fetch: routerWrapper.fetchHandler.bind(routerWrapper)
+};
 ```
 
 Useful package.json scripts:
-```json:
-...
+```json
+{
     "scripts": {
         "build": "tsc",
-        "debug": "tsx --inspect node_modules/edge.libx.js/src/helpers/localServer.ts src/index.ts",
-        "debug:watch": "nodemon --watch 'src/**/*.ts' --exec tsx --inspect node_modules/edge.libx.js/src/helpers/localServer.ts src/index.ts",
+        "watch": "tsc -w",
+        "test": "jest",
+        "format": "prettier --config .prettierrc 'src/**/*.ts' 'tests/**/*.ts' --write"
+    }
+}
+```
+
+## Features:
 
-        "set-secrets": "set-secrets .env.preview preview \"vercel env add\" remove",
+### CORS Support
+Built-in CORS handling with configurable options:
+```ts
+const routerWrapper = RouterWrapper.getNew('/api', {
+	origin: ['https://example.com', 'https://app.example.com'],
+	allowMethods: ['GET', 'POST', 'PUT', 'DELETE'],
+	allowHeaders: ['Content-Type', 'Authorization', 'X-API-Key']
+});
+```
 
+### Error Handling
+Automatic error handling with proper HTTP status codes:
+```ts
+routerWrapper.router.get('/error-example', async () => {
+	throw new Error('Something went wrong'); // Returns 500 with error message
+});
+```
+
+### Local Development
+For local development with Express.js:
+```ts
+// Create server adapter for local development
+const server = routerWrapper.createServerAdapter();
+
+// Start local server (HTTP)
+tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js
+
+// Start local server with HTTPS (self-signed certificate)
+tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js --https
+
+// Or set environment variable
+useHttps=true tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js
+```
+
+Add these scripts to your `package.json`:
+```json
+{
+    "scripts": {
+        "dev": "tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js",
+        "dev:https": "tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js --https",
+        "dev:watch": "nodemon --watch 'src/**/*.ts' --exec tsx node_modules/edge.libx.js/build/helpers/localServer.js src/index.js"
     }
-...
+}
+```
+
+### Route Registration
+Register sub-routers for modular organization:
+```ts
+const subRouter = RouterWrapper.getNew('/users');
+subRouter.router.get('/:id', async (req) => {
+	return json({ userId: req.params.id });
+});
+
+routerWrapper.registerRoute('/users', () => subRouter);
 ```
 
 ## Contribute:

package/build/main.d.ts

@@ -1,2 +1,3 @@
 export { RouterWrapper } from "./modules/RouterWrapper";
+export { MCPAdapter } from "./modules/MCPAdapter";
 export * as cors from "./modules/cors";

package/build/main.js

@@ -33,8 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cors = exports.RouterWrapper = void 0;
+exports.cors = exports.MCPAdapter = exports.RouterWrapper = void 0;
 var RouterWrapper_1 = require("./modules/RouterWrapper");
 Object.defineProperty(exports, "RouterWrapper", { enumerable: true, get: function () { return RouterWrapper_1.RouterWrapper; } });
+var MCPAdapter_1 = require("./modules/MCPAdapter");
+Object.defineProperty(exports, "MCPAdapter", { enumerable: true, get: function () { return MCPAdapter_1.MCPAdapter; } });
 exports.cors = __importStar(require("./modules/cors"));
 //# sourceMappingURL=main.js.map

package/build/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAAuC","sourcesContent":["export { RouterWrapper } from \"./modules/RouterWrapper\";\nexport * as cors from \"./modules/cors\";"]}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,mDAAkD;AAAzC,wGAAA,UAAU,OAAA;AACnB,uDAAuC","sourcesContent":["export { RouterWrapper } from \"./modules/RouterWrapper\";\nexport { MCPAdapter } from \"./modules/MCPAdapter\";\nexport * as cors from \"./modules/cors\";"]}

package/build/modules/MCPAdapter.d.ts

@@ -0,0 +1,45 @@
+import { RouterType, IRequest } from 'itty-router';
+export interface MCPOptions {
+    name?: string;
+    version?: string;
+}
+interface ToolMeta {
+    description?: string;
+    params?: Record<string, {
+        description?: string;
+        type?: string;
+    }>;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required: string[];
+    };
+}
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method: string;
+    params?: any;
+}
+export declare class MCPAdapter {
+    private router;
+    private base;
+    private fetchHandler;
+    private serverName;
+    private serverVersion;
+    private mcpMeta;
+    constructor(router: RouterType<any, any[], any>, base: string, fetchHandler: (request: IRequest, ctx?: any) => Promise<Response>, mcpMeta: Map<string, ToolMeta>, options?: MCPOptions);
+    toolNameFromRoute(method: string, path: string): string;
+    inferQueryParams(handlers: Function[]): string[];
+    introspectRoutes(): ToolDefinition[];
+    private findRoute;
+    callTool(name: string, args?: Record<string, any>): Promise<any>;
+    handleJsonRpc(message: JsonRpcRequest): Promise<any>;
+    httpHandler: (request: Request) => Promise<Response>;
+    serveStdio(): Promise<void>;
+}
+export {};

package/build/modules/MCPAdapter.js

@@ -0,0 +1,291 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPAdapter = void 0;
+class MCPAdapter {
+    constructor(router, base, fetchHandler, mcpMeta, options) {
+        var _a, _b;
+        this.httpHandler = (request) => __awaiter(this, void 0, void 0, function* () {
+            if (request.method === 'GET') {
+                const stream = new ReadableStream({
+                    start(controller) {
+                        const encoder = new TextEncoder();
+                        controller.enqueue(encoder.encode(`event: endpoint\ndata: /mcp\n\n`));
+                    },
+                });
+                return new Response(stream, {
+                    headers: {
+                        'Content-Type': 'text/event-stream',
+                        'Cache-Control': 'no-cache',
+                        'Connection': 'keep-alive',
+                    },
+                });
+            }
+            try {
+                const body = yield request.json();
+                const result = yield this.handleJsonRpc(body);
+                if (result === null) {
+                    return new Response(null, { status: 204 });
+                }
+                return new Response(JSON.stringify(result), {
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+            catch (err) {
+                return new Response(JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: null,
+                    error: { code: -32700, message: 'Parse error' },
+                }), {
+                    status: 400,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+        });
+        this.router = router;
+        this.base = base;
+        this.fetchHandler = fetchHandler;
+        this.mcpMeta = mcpMeta;
+        this.serverName = (_a = options === null || options === void 0 ? void 0 : options.name) !== null && _a !== void 0 ? _a : 'MCP Server';
+        this.serverVersion = (_b = options === null || options === void 0 ? void 0 : options.version) !== null && _b !== void 0 ? _b : '1.0.0';
+    }
+    toolNameFromRoute(method, path) {
+        let name = path;
+        if (this.base && name.startsWith(this.base)) {
+            name = name.slice(this.base.length);
+        }
+        name = name.replace(/^\//, '');
+        name = name.replace(/:(\w+)/g, 'by_$1');
+        name = name.replace(/\//g, '_');
+        name = `${method.toLowerCase()}_${name}`;
+        name = name.replace(/_+/g, '_').replace(/_$/, '');
+        return name;
+    }
+    inferQueryParams(handlers) {
+        const params = new Set();
+        for (const handler of handlers) {
+            try {
+                const src = handler.toString();
+                const dotPattern = /(?:req(?:uest)?\.)?query\.(\w+)/g;
+                let match;
+                while ((match = dotPattern.exec(src)) !== null) {
+                    params.add(match[1]);
+                }
+                const bracketPattern = /(?:req(?:uest)?\.)?query\[['"](\w+)['"]\]/g;
+                while ((match = bracketPattern.exec(src)) !== null) {
+                    params.add(match[1]);
+                }
+            }
+            catch (_a) {
+            }
+        }
+        return Array.from(params);
+    }
+    introspectRoutes() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+        const routes = (_a = this.router.routes) !== null && _a !== void 0 ? _a : [];
+        const tools = [];
+        for (const route of routes) {
+            const [method, , handlers, originalPath] = route;
+            if (!originalPath || originalPath === '*' || originalPath.endsWith('/*'))
+                continue;
+            if (method === 'OPTIONS' || method === 'ALL')
+                continue;
+            const toolName = this.toolNameFromRoute(method, originalPath);
+            const metaKey = `${method}:${originalPath}`;
+            const meta = this.mcpMeta.get(metaKey);
+            const properties = {};
+            const required = [];
+            const paramPattern = /:(\w+)/g;
+            let match;
+            while ((match = paramPattern.exec(originalPath)) !== null) {
+                const paramName = match[1];
+                properties[paramName] = Object.assign({ type: (_d = (_c = (_b = meta === null || meta === void 0 ? void 0 : meta.params) === null || _b === void 0 ? void 0 : _b[paramName]) === null || _c === void 0 ? void 0 : _c.type) !== null && _d !== void 0 ? _d : 'string' }, (((_f = (_e = meta === null || meta === void 0 ? void 0 : meta.params) === null || _e === void 0 ? void 0 : _e[paramName]) === null || _f === void 0 ? void 0 : _f.description) && { description: meta.params[paramName].description }));
+                required.push(paramName);
+            }
+            if (['POST', 'PUT', 'PATCH'].includes(method)) {
+                properties['body'] = {
+                    type: 'object',
+                    description: (_j = (_h = (_g = meta === null || meta === void 0 ? void 0 : meta.params) === null || _g === void 0 ? void 0 : _g['body']) === null || _h === void 0 ? void 0 : _h.description) !== null && _j !== void 0 ? _j : 'Request body',
+                };
+            }
+            if (['GET', 'DELETE'].includes(method)) {
+                const queryParams = this.inferQueryParams(handlers);
+                for (const qp of queryParams) {
+                    if (!properties[qp]) {
+                        properties[qp] = Object.assign({ type: (_m = (_l = (_k = meta === null || meta === void 0 ? void 0 : meta.params) === null || _k === void 0 ? void 0 : _k[qp]) === null || _l === void 0 ? void 0 : _l.type) !== null && _m !== void 0 ? _m : 'string' }, (((_p = (_o = meta === null || meta === void 0 ? void 0 : meta.params) === null || _o === void 0 ? void 0 : _o[qp]) === null || _p === void 0 ? void 0 : _p.description) && { description: meta.params[qp].description }));
+                    }
+                }
+            }
+            const description = (_q = meta === null || meta === void 0 ? void 0 : meta.description) !== null && _q !== void 0 ? _q : `${method} ${originalPath}`;
+            tools.push({
+                name: toolName,
+                description,
+                inputSchema: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            });
+        }
+        return tools;
+    }
+    findRoute(toolName) {
+        var _a;
+        const routes = (_a = this.router.routes) !== null && _a !== void 0 ? _a : [];
+        for (const route of routes) {
+            const [method, , handlers, originalPath] = route;
+            if (!originalPath || originalPath === '*' || originalPath.endsWith('/*'))
+                continue;
+            if (method === 'OPTIONS' || method === 'ALL')
+                continue;
+            if (this.toolNameFromRoute(method, originalPath) === toolName) {
+                return { method, path: originalPath, handlers };
+            }
+        }
+        return null;
+    }
+    callTool(name_1) {
+        return __awaiter(this, arguments, void 0, function* (name, args = {}) {
+            var _a;
+            const route = this.findRoute(name);
+            if (!route) {
+                return { isError: true, content: [{ type: 'text', text: `Unknown tool: ${name}` }] };
+            }
+            const { method, path } = route;
+            let url = path;
+            const pathParamPattern = /:(\w+)/g;
+            let match;
+            while ((match = pathParamPattern.exec(path)) !== null) {
+                const paramName = match[1];
+                if (args[paramName] != null) {
+                    url = url.replace(`:${paramName}`, encodeURIComponent(String(args[paramName])));
+                }
+            }
+            const pathParams = new Set();
+            const ppPattern = /:(\w+)/g;
+            let m;
+            while ((m = ppPattern.exec(path)) !== null)
+                pathParams.add(m[1]);
+            const queryParams = [];
+            for (const [key, value] of Object.entries(args)) {
+                if (key === 'body' || pathParams.has(key))
+                    continue;
+                queryParams.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+            }
+            if (queryParams.length > 0) {
+                url += '?' + queryParams.join('&');
+            }
+            const fullUrl = `http://localhost${url}`;
+            const requestInit = { method };
+            if (args.body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+                requestInit.body = JSON.stringify(args.body);
+                requestInit.headers = { 'Content-Type': 'application/json' };
+            }
+            const request = new Request(fullUrl, requestInit);
+            try {
+                const response = yield this.fetchHandler(request);
+                const text = yield response.text();
+                let content;
+                try {
+                    content = JSON.parse(text);
+                }
+                catch (_b) {
+                    content = text;
+                }
+                return {
+                    content: [{ type: 'text', text: typeof content === 'string' ? content : JSON.stringify(content) }],
+                };
+            }
+            catch (err) {
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: (_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : String(err) }],
+                };
+            }
+        });
+    }
+    handleJsonRpc(message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { method, id, params } = message;
+            switch (method) {
+                case 'initialize':
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            protocolVersion: '2024-11-05',
+                            capabilities: { tools: { listChanged: true } },
+                            serverInfo: { name: this.serverName, version: this.serverVersion },
+                        },
+                    };
+                case 'notifications/initialized':
+                    return null;
+                case 'tools/list':
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: { tools: this.introspectRoutes() },
+                    };
+                case 'tools/call': {
+                    const result = yield this.callTool(params === null || params === void 0 ? void 0 : params.name, (_a = params === null || params === void 0 ? void 0 : params.arguments) !== null && _a !== void 0 ? _a : {});
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result,
+                    };
+                }
+                default:
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        error: { code: -32601, message: `Method not found: ${method}` },
+                    };
+            }
+        });
+    }
+    serveStdio() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stdin = globalThis.process.stdin;
+            const stdout = globalThis.process.stdout;
+            stdin.setEncoding('utf8');
+            let buffer = '';
+            stdin.on('data', (chunk) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                buffer += chunk;
+                const lines = buffer.split('\n');
+                buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    try {
+                        const message = JSON.parse(trimmed);
+                        const result = yield this.handleJsonRpc(message);
+                        if (result !== null) {
+                            stdout.write(JSON.stringify(result) + '\n');
+                        }
+                    }
+                    catch (_b) {
+                        stdout.write(JSON.stringify({
+                            jsonrpc: '2.0',
+                            id: null,
+                            error: { code: -32700, message: 'Parse error' },
+                        }) + '\n');
+                    }
+                }
+            }));
+        });
+    }
+}
+exports.MCPAdapter = MCPAdapter;
+//# sourceMappingURL=MCPAdapter.js.map

package/build/modules/MCPAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPAdapter.js","sourceRoot":"","sources":["../../src/modules/MCPAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["import { RouterType, IRequest } from 'itty-router';\n\nexport interface MCPOptions {\n\tname?: string;\n\tversion?: string;\n}\n\ninterface ToolMeta {\n\tdescription?: string;\n\tparams?: Record<string, { description?: string; type?: string }>;\n}\n\ninterface ToolDefinition {\n\tname: string;\n\tdescription: string;\n\tinputSchema: {\n\t\ttype: 'object';\n\t\tproperties: Record<string, any>;\n\t\trequired: string[];\n\t};\n}\n\ninterface JsonRpcRequest {\n\tjsonrpc: '2.0';\n\tid?: string | number;\n\tmethod: string;\n\tparams?: any;\n}\n\nexport class MCPAdapter {\n\tprivate router: RouterType<any, any[], any>;\n\tprivate base: string;\n\tprivate fetchHandler: (request: IRequest, ctx?: any) => Promise<Response>;\n\tprivate serverName: string;\n\tprivate serverVersion: string;\n\tprivate mcpMeta: Map<string, ToolMeta>;\n\n\tconstructor(\n\t\trouter: RouterType<any, any[], any>,\n\t\tbase: string,\n\t\tfetchHandler: (request: IRequest, ctx?: any) => Promise<Response>,\n\t\tmcpMeta: Map<string, ToolMeta>,\n\t\toptions?: MCPOptions,\n\t) {\n\t\tthis.router = router;\n\t\tthis.base = base;\n\t\tthis.fetchHandler = fetchHandler;\n\t\tthis.mcpMeta = mcpMeta;\n\t\tthis.serverName = options?.name ?? 'MCP Server';\n\t\tthis.serverVersion = options?.version ?? '1.0.0';\n\t}\n\n\tpublic toolNameFromRoute(method: string, path: string): string {\n\t\tlet name = path;\n\t\t// Strip base path\n\t\tif (this.base && name.startsWith(this.base)) {\n\t\t\tname = name.slice(this.base.length);\n\t\t}\n\t\t// Remove leading slash\n\t\tname = name.replace(/^\\//, '');\n\t\t// Replace :param with \"by_param\"\n\t\tname = name.replace(/:(\\w+)/g, 'by_$1');\n\t\t// Replace slashes with underscores\n\t\tname = name.replace(/\\//g, '_');\n\t\t// Prepend method\n\t\tname = `${method.toLowerCase()}_${name}`;\n\t\t// Clean up double underscores\n\t\tname = name.replace(/_+/g, '_').replace(/_$/, '');\n\t\treturn name;\n\t}\n\n\tpublic inferQueryParams(handlers: Function[]): string[] {\n\t\tconst params = new Set<string>();\n\t\tfor (const handler of handlers) {\n\t\t\ttry {\n\t\t\t\tconst src = handler.toString();\n\t\t\t\t// Match req.query.paramName, request.query.paramName, query.paramName\n\t\t\t\tconst dotPattern = /(?:req(?:uest)?\\.)?query\\.(\\w+)/g;\n\t\t\t\tlet match: RegExpExecArray | null;\n\t\t\t\twhile ((match = dotPattern.exec(src)) !== null) {\n\t\t\t\t\tparams.add(match[1]);\n\t\t\t\t}\n\t\t\t\t// Match req.query['paramName'] or req.query[\"paramName\"]\n\t\t\t\tconst bracketPattern = /(?:req(?:uest)?\\.)?query\\[['\"](\\w+)['\"]\\]/g;\n\t\t\t\twhile ((match = bracketPattern.exec(src)) !== null) {\n\t\t\t\t\tparams.add(match[1]);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// handler.toString() may fail for native code\n\t\t\t}\n\t\t}\n\t\treturn Array.from(params);\n\t}\n\n\tpublic introspectRoutes(): ToolDefinition[] {\n\t\tconst routes: any[] = (this.router as any).routes ?? [];\n\t\tconst tools: ToolDefinition[] = [];\n\n\t\tfor (const route of routes) {\n\t\t\t// itty-router v5 stores routes as [method, regex, handlers[], path]\n\t\t\tconst [method, , handlers, originalPath] = route;\n\n\t\t\t// Skip wildcard catch-alls and OPTIONS\n\t\t\tif (!originalPath || originalPath === '*' || originalPath.endsWith('/*')) continue;\n\t\t\tif (method === 'OPTIONS' || method === 'ALL') continue;\n\n\t\t\tconst toolName = this.toolNameFromRoute(method, originalPath);\n\t\t\tconst metaKey = `${method}:${originalPath}`;\n\t\t\tconst meta = this.mcpMeta.get(metaKey);\n\n\t\t\tconst properties: Record<string, any> = {};\n\t\t\tconst required: string[] = [];\n\n\t\t\t// Extract path params\n\t\t\tconst paramPattern = /:(\\w+)/g;\n\t\t\tlet match: RegExpExecArray | null;\n\t\t\twhile ((match = paramPattern.exec(originalPath)) !== null) {\n\t\t\t\tconst paramName = match[1];\n\t\t\t\tproperties[paramName] = {\n\t\t\t\t\ttype: meta?.params?.[paramName]?.type ?? 'string',\n\t\t\t\t\t...(meta?.params?.[paramName]?.description && { description: meta.params[paramName].description }),\n\t\t\t\t};\n\t\t\t\trequired.push(paramName);\n\t\t\t}\n\n\t\t\t// POST/PUT/PATCH get a body property\n\t\t\tif (['POST', 'PUT', 'PATCH'].includes(method)) {\n\t\t\t\tproperties['body'] = {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tdescription: meta?.params?.['body']?.description ?? 'Request body',\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Infer query params for GET/DELETE\n\t\t\tif (['GET', 'DELETE'].includes(method)) {\n\t\t\t\tconst queryParams = this.inferQueryParams(handlers);\n\t\t\t\tfor (const qp of queryParams) {\n\t\t\t\t\tif (!properties[qp]) {\n\t\t\t\t\t\tproperties[qp] = {\n\t\t\t\t\t\t\ttype: meta?.params?.[qp]?.type ?? 'string',\n\t\t\t\t\t\t\t...(meta?.params?.[qp]?.description && { description: meta.params[qp].description }),\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst description = meta?.description ?? `${method} ${originalPath}`;\n\n\t\t\ttools.push({\n\t\t\t\tname: toolName,\n\t\t\t\tdescription,\n\t\t\t\tinputSchema: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties,\n\t\t\t\t\trequired,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\treturn tools;\n\t}\n\n\tprivate findRoute(toolName: string): { method: string; path: string; handlers: Function[] } | null {\n\t\tconst routes: any[] = (this.router as any).routes ?? [];\n\t\tfor (const route of routes) {\n\t\t\tconst [method, , handlers, originalPath] = route;\n\t\t\tif (!originalPath || originalPath === '*' || originalPath.endsWith('/*')) continue;\n\t\t\tif (method === 'OPTIONS' || method === 'ALL') continue;\n\t\t\tif (this.toolNameFromRoute(method, originalPath) === toolName) {\n\t\t\t\treturn { method, path: originalPath, handlers };\n\t\t\t}\n\t\t}\n\t\treturn null;\n\t}\n\n\tpublic async callTool(name: string, args: Record<string, any> = {}): Promise<any> {\n\t\tconst route = this.findRoute(name);\n\t\tif (!route) {\n\t\t\treturn { isError: true, content: [{ type: 'text', text: `Unknown tool: ${name}` }] };\n\t\t}\n\n\t\tconst { method, path } = route;\n\n\t\t// Build URL with path params substituted\n\t\tlet url = path;\n\t\tconst pathParamPattern = /:(\\w+)/g;\n\t\tlet match: RegExpExecArray | null;\n\t\twhile ((match = pathParamPattern.exec(path)) !== null) {\n\t\t\tconst paramName = match[1];\n\t\t\tif (args[paramName] != null) {\n\t\t\t\turl = url.replace(`:${paramName}`, encodeURIComponent(String(args[paramName])));\n\t\t\t}\n\t\t}\n\n\t\t// Build query string for non-path, non-body params\n\t\tconst pathParams = new Set<string>();\n\t\tconst ppPattern = /:(\\w+)/g;\n\t\tlet m: RegExpExecArray | null;\n\t\twhile ((m = ppPattern.exec(path)) !== null) pathParams.add(m[1]);\n\n\t\tconst queryParams: string[] = [];\n\t\tfor (const [key, value] of Object.entries(args)) {\n\t\t\tif (key === 'body' || pathParams.has(key)) continue;\n\t\t\tqueryParams.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n\t\t}\n\t\tif (queryParams.length > 0) {\n\t\t\turl += '?' + queryParams.join('&');\n\t\t}\n\n\t\tconst fullUrl = `http://localhost${url}`;\n\t\tconst requestInit: RequestInit = { method };\n\t\tif (args.body && ['POST', 'PUT', 'PATCH'].includes(method)) {\n\t\t\trequestInit.body = JSON.stringify(args.body);\n\t\t\trequestInit.headers = { 'Content-Type': 'application/json' };\n\t\t}\n\n\t\tconst request = new Request(fullUrl, requestInit);\n\n\t\ttry {\n\t\t\tconst response = await this.fetchHandler(request as any);\n\t\t\tconst text = await response.text();\n\t\t\tlet content: any;\n\t\t\ttry {\n\t\t\t\tcontent = JSON.parse(text);\n\t\t\t} catch {\n\t\t\t\tcontent = text;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: 'text', text: typeof content === 'string' ? content : JSON.stringify(content) }],\n\t\t\t};\n\t\t} catch (err: any) {\n\t\t\treturn {\n\t\t\t\tisError: true,\n\t\t\t\tcontent: [{ type: 'text', text: err?.message ?? String(err) }],\n\t\t\t};\n\t\t}\n\t}\n\n\tpublic async handleJsonRpc(message: JsonRpcRequest): Promise<any> {\n\t\tconst { method, id, params } = message;\n\n\t\tswitch (method) {\n\t\t\tcase 'initialize':\n\t\t\t\treturn {\n\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\tid,\n\t\t\t\t\tresult: {\n\t\t\t\t\t\tprotocolVersion: '2024-11-05',\n\t\t\t\t\t\tcapabilities: { tools: { listChanged: true } },\n\t\t\t\t\t\tserverInfo: { name: this.serverName, version: this.serverVersion },\n\t\t\t\t\t},\n\t\t\t\t};\n\n\t\t\tcase 'notifications/initialized':\n\t\t\t\t// No response needed for notifications\n\t\t\t\treturn null;\n\n\t\t\tcase 'tools/list':\n\t\t\t\treturn {\n\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\tid,\n\t\t\t\t\tresult: { tools: this.introspectRoutes() },\n\t\t\t\t};\n\n\t\t\tcase 'tools/call': {\n\t\t\t\tconst result = await this.callTool(params?.name, params?.arguments ?? {});\n\t\t\t\treturn {\n\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\tid,\n\t\t\t\t\tresult,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tdefault:\n\t\t\t\treturn {\n\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\tid,\n\t\t\t\t\terror: { code: -32601, message: `Method not found: ${method}` },\n\t\t\t\t};\n\t\t}\n\t}\n\n\tpublic httpHandler = async (request: Request): Promise<Response> => {\n\t\tif (request.method === 'GET') {\n\t\t\t// SSE endpoint for server-sent events (Streamable HTTP)\n\t\t\tconst stream = new ReadableStream({\n\t\t\t\tstart(controller) {\n\t\t\t\t\tconst encoder = new TextEncoder();\n\t\t\t\t\tcontroller.enqueue(encoder.encode(`event: endpoint\\ndata: /mcp\\n\\n`));\n\t\t\t\t\t// Keep connection open - client will close\n\t\t\t\t},\n\t\t\t});\n\t\t\treturn new Response(stream, {\n\t\t\t\theaders: {\n\t\t\t\t\t'Content-Type': 'text/event-stream',\n\t\t\t\t\t'Cache-Control': 'no-cache',\n\t\t\t\t\t'Connection': 'keep-alive',\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\t// POST: JSON-RPC request\n\t\ttry {\n\t\t\tconst body = await request.json() as JsonRpcRequest;\n\t\t\tconst result = await this.handleJsonRpc(body);\n\t\t\tif (result === null) {\n\t\t\t\treturn new Response(null, { status: 204 });\n\t\t\t}\n\t\t\treturn new Response(JSON.stringify(result), {\n\t\t\t\theaders: { 'Content-Type': 'application/json' },\n\t\t\t});\n\t\t} catch (err: any) {\n\t\t\treturn new Response(JSON.stringify({\n\t\t\t\tjsonrpc: '2.0',\n\t\t\t\tid: null,\n\t\t\t\terror: { code: -32700, message: 'Parse error' },\n\t\t\t}), {\n\t\t\t\tstatus: 400,\n\t\t\t\theaders: { 'Content-Type': 'application/json' },\n\t\t\t});\n\t\t}\n\t};\n\n\tpublic async serveStdio(): Promise<void> {\n\t\tconst stdin = (globalThis as any).process.stdin;\n\t\tconst stdout = (globalThis as any).process.stdout;\n\n\t\tstdin.setEncoding('utf8');\n\n\t\tlet buffer = '';\n\t\tstdin.on('data', async (chunk: string) => {\n\t\t\tbuffer += chunk;\n\t\t\t// Process complete lines\n\t\t\tconst lines = buffer.split('\\n');\n\t\t\tbuffer = lines.pop() ?? '';\n\n\t\t\tfor (const line of lines) {\n\t\t\t\tconst trimmed = line.trim();\n\t\t\t\tif (!trimmed) continue;\n\t\t\t\ttry {\n\t\t\t\t\tconst message = JSON.parse(trimmed) as JsonRpcRequest;\n\t\t\t\t\tconst result = await this.handleJsonRpc(message);\n\t\t\t\t\tif (result !== null) {\n\t\t\t\t\t\tstdout.write(JSON.stringify(result) + '\\n');\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\tstdout.write(JSON.stringify({\n\t\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\t\tid: null,\n\t\t\t\t\t\terror: { code: -32700, message: 'Parse error' },\n\t\t\t\t\t}) + '\\n');\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t}\n}\n"]}

package/build/modules/RouterWrapper.d.ts

@@ -1,4 +1,5 @@
 import { RouterType, cors, IRequest } from 'itty-router';
+import { MCPAdapter, MCPOptions } from './MCPAdapter';
 type BaseRouterInitializer = (string: any) => {
     base: string;
     router: RouterType<IRequest, any[]>;
@@ -10,6 +11,7 @@ export declare class RouterWrapper<TCtx = any> {
     private cors;
     private preflight;
     private corsify;
+    private mcpMeta;
     constructor(base: string, router: RouterType<Request, [], any>, corsOptions?: CorsOptions);
     static getNew(base: string, corsOptions?: CorsOptions): RouterWrapper<any>;
     static errorHandler(error: any): Response;
@@ -17,5 +19,13 @@ export declare class RouterWrapper<TCtx = any> {
     fetchHandler(request: IRequest, ctx: TCtx): Promise<Response>;
     catchNotFound(): void;
     createServerAdapter(): import("@whatwg-node/server").ServerAdapter<{}, import("@whatwg-node/server").ServerAdapterBaseObject<{}, any>>;
+    describeMCP(path: string, method: string, meta: {
+        description?: string;
+        params?: Record<string, {
+            description?: string;
+            type?: string;
+        }>;
+    }): void;
+    asMCP(options?: MCPOptions): MCPAdapter;
 }
 export {};

package/build/modules/RouterWrapper.js

@@ -4,10 +4,12 @@ exports.RouterWrapper = void 0;
 const essentials_js_1 = require("libx.js/build/bundles/essentials.js");
 const itty_router_1 = require("itty-router");
 const server_1 = require("@whatwg-node/server");
+const MCPAdapter_1 = require("./MCPAdapter");
 class RouterWrapper {
     constructor(base, router, corsOptions) {
         this.base = base;
         this.router = router;
+        this.mcpMeta = new Map();
         this.cors = (0, itty_router_1.cors)(corsOptions !== null && corsOptions !== void 0 ? corsOptions : {
             origin: '*',
             allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS', 'PATCH'],
@@ -55,6 +57,13 @@ class RouterWrapper {
         const ittyServer = (0, server_1.createServerAdapter)(this.fetchHandler.bind(this));
         return ittyServer;
     }
+    describeMCP(path, method, meta) {
+        const key = `${method.toUpperCase()}:${this.base}${path}`;
+        this.mcpMeta.set(key, meta);
+    }
+    asMCP(options) {
+        return new MCPAdapter_1.MCPAdapter(this.router, this.base, this.fetchHandler.bind(this), this.mcpMeta, options);
+    }
 }
 exports.RouterWrapper = RouterWrapper;
 //# sourceMappingURL=RouterWrapper.js.map

package/build/modules/RouterWrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouterWrapper.js","sourceRoot":"","sources":["../../src/modules/RouterWrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { libx } from 'libx.js/build/bundles/essentials.js';\nimport { Route, Router, RouterType, error, json, cors, withParams, IRequest, text, ResponseHandler } from 'itty-router';\nimport { createServerAdapter } from '@whatwg-node/server';\n\ntype BaseRouterInitializer = (string) => { base: string; router: RouterType<IRequest, any[]> };\ntype CorsOptions = Parameters<typeof cors>[0];\n\nexport class RouterWrapper<TCtx = any> {\n\tprivate cors: ReturnType<typeof cors>;\n\tprivate preflight: (request: Request) => Response | Promise<Response>;\n\tprivate corsify: (response: Response, request: Request) => Response | Promise<Response>;\n\n\tpublic constructor(\n\t\tpublic base: string,\n\t\tpublic router: RouterType<Request, [], any>,\n\t\tcorsOptions?: CorsOptions\n\t) {\n\t\tthis.cors = cors(corsOptions ?? {\n\t\t\torigin: '*',\n\t\t\tallowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS', 'PATCH'],\n\t\t\tallowHeaders: ['Content-Type', 'Authorization'],\n\t\t\texposeHeaders: ['Content-Type', 'Authorization'],\n\t\t});\n\t\tthis.preflight = this.cors.preflight;\n\t\tthis.corsify = this.cors.corsify;\n\t}\n\n\tpublic static getNew(base: string, corsOptions?: CorsOptions) {\n\t\tconst temp = new RouterWrapper(base, Router({ base }), corsOptions);\n\t\tconst router = Router({\n\t\t\tbase,\n\t\t\tbefore: [temp.preflight],\n\t\t\tcatch: RouterWrapper.errorHandler,\n\t\t});\n\t\trouter.all('*', withParams);\n\t\treturn new RouterWrapper(base, router, corsOptions);\n\t}\n\n\tpublic static errorHandler(error) {\n\t\tconst isObject = libx.isObject(error);\n\t\tconst errMessage = error?.message ?? error;\n\t\tconst msg = 'Error: ' + (!isObject ? (errMessage ?? 'Server Error') : JSON.stringify(error));\n\t\tconst status = parseInt(error?.status ?? error?.statusCode ?? error?.code ?? error?.error?.code) || 500;\n\t\tconsole.error('Server error: ', error, status);\n\t\treturn new Response(msg, { status })\n\t}\n\n\tpublic registerRoute(newBase: string, baseRouterInitializer: BaseRouterInitializer) {\n\t\tconst route = baseRouterInitializer(`${this.base}${newBase}`);\n\t\tthis.router.all(newBase + '/*', route.router.fetch);\n\t\treturn this.router;\n\t};\n\n\tpublic fetchHandler(request: IRequest, ctx: TCtx) {\n\t\treturn this.router.fetch(request, ctx)\n\t\t\t.then(json)\n\t\t\t.catch(RouterWrapper.errorHandler)\n\t\t\t.then((res) => this.corsify(res, request));\n\t}\n\n\tpublic catchNotFound() {\n\t\tthis.router.all('*', () => error(404));\n\t}\n\n\tpublic createServerAdapter() {\n\t\tconst ittyServer = createServerAdapter(this.fetchHandler.bind(this));\n\t\treturn ittyServer;\n\t}\n}"]}
+{"version":3,"file":"RouterWrapper.js","sourceRoot":"","sources":["../../src/modules/RouterWrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { libx } from 'libx.js/build/bundles/essentials.js';\nimport { Route, Router, RouterType, error, json, cors, withParams, IRequest, text, ResponseHandler } from 'itty-router';\nimport { createServerAdapter } from '@whatwg-node/server';\nimport { MCPAdapter, MCPOptions } from './MCPAdapter';\n\ntype BaseRouterInitializer = (string) => { base: string; router: RouterType<IRequest, any[]> };\ntype CorsOptions = Parameters<typeof cors>[0];\n\nexport class RouterWrapper<TCtx = any> {\n\tprivate cors: ReturnType<typeof cors>;\n\tprivate preflight: (request: Request) => Response | Promise<Response>;\n\tprivate corsify: (response: Response, request: Request) => Response | Promise<Response>;\n\tprivate mcpMeta: Map<string, { description?: string; params?: Record<string, { description?: string; type?: string }> }> = new Map();\n\n\tpublic constructor(\n\t\tpublic base: string,\n\t\tpublic router: RouterType<Request, [], any>,\n\t\tcorsOptions?: CorsOptions\n\t) {\n\t\tthis.cors = cors(corsOptions ?? {\n\t\t\torigin: '*',\n\t\t\tallowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS', 'PATCH'],\n\t\t\tallowHeaders: ['Content-Type', 'Authorization'],\n\t\t\texposeHeaders: ['Content-Type', 'Authorization'],\n\t\t});\n\t\tthis.preflight = this.cors.preflight;\n\t\tthis.corsify = this.cors.corsify;\n\t}\n\n\tpublic static getNew(base: string, corsOptions?: CorsOptions) {\n\t\tconst temp = new RouterWrapper(base, Router({ base }), corsOptions);\n\t\tconst router = Router({\n\t\t\tbase,\n\t\t\tbefore: [temp.preflight],\n\t\t\tcatch: RouterWrapper.errorHandler,\n\t\t});\n\t\trouter.all('*', withParams);\n\t\treturn new RouterWrapper(base, router, corsOptions);\n\t}\n\n\tpublic static errorHandler(error) {\n\t\tconst isObject = libx.isObject(error);\n\t\tconst errMessage = error?.message ?? error;\n\t\tconst msg = 'Error: ' + (!isObject ? (errMessage ?? 'Server Error') : JSON.stringify(error));\n\t\tconst status = parseInt(error?.status ?? error?.statusCode ?? error?.code ?? error?.error?.code) || 500;\n\t\tconsole.error('Server error: ', error, status);\n\t\treturn new Response(msg, { status })\n\t}\n\n\tpublic registerRoute(newBase: string, baseRouterInitializer: BaseRouterInitializer) {\n\t\tconst route = baseRouterInitializer(`${this.base}${newBase}`);\n\t\tthis.router.all(newBase + '/*', route.router.fetch);\n\t\treturn this.router;\n\t};\n\n\tpublic fetchHandler(request: IRequest, ctx: TCtx) {\n\t\treturn this.router.fetch(request, ctx)\n\t\t\t.then(json)\n\t\t\t.catch(RouterWrapper.errorHandler)\n\t\t\t.then((res) => this.corsify(res, request));\n\t}\n\n\tpublic catchNotFound() {\n\t\tthis.router.all('*', () => error(404));\n\t}\n\n\tpublic createServerAdapter() {\n\t\tconst ittyServer = createServerAdapter(this.fetchHandler.bind(this));\n\t\treturn ittyServer;\n\t}\n\n\tpublic describeMCP(path: string, method: string, meta: { description?: string; params?: Record<string, { description?: string; type?: string }> }) {\n\t\tconst key = `${method.toUpperCase()}:${this.base}${path}`;\n\t\tthis.mcpMeta.set(key, meta);\n\t}\n\n\tpublic asMCP(options?: MCPOptions): MCPAdapter {\n\t\treturn new MCPAdapter(\n\t\t\tthis.router,\n\t\t\tthis.base,\n\t\t\tthis.fetchHandler.bind(this),\n\t\t\tthis.mcpMeta,\n\t\t\toptions,\n\t\t);\n\t}\n}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "edge.libx.js",
-    "version": "0.2.4",
+    "version": "0.3.0",
     "main": "build/main.js",
     "license": "MIT",
     "author": "Elya Livshitz",

package/src/main.ts

@@ -1,2 +1,3 @@
 export { RouterWrapper } from "./modules/RouterWrapper";
+export { MCPAdapter } from "./modules/MCPAdapter";
 export * as cors from "./modules/cors";

package/src/modules/MCPAdapter.ts

@@ -0,0 +1,356 @@
+import { RouterType, IRequest } from 'itty-router';
+
+export interface MCPOptions {
+	name?: string;
+	version?: string;
+}
+
+interface ToolMeta {
+	description?: string;
+	params?: Record<string, { description?: string; type?: string }>;
+}
+
+interface ToolDefinition {
+	name: string;
+	description: string;
+	inputSchema: {
+		type: 'object';
+		properties: Record<string, any>;
+		required: string[];
+	};
+}
+
+interface JsonRpcRequest {
+	jsonrpc: '2.0';
+	id?: string | number;
+	method: string;
+	params?: any;
+}
+
+export class MCPAdapter {
+	private router: RouterType<any, any[], any>;
+	private base: string;
+	private fetchHandler: (request: IRequest, ctx?: any) => Promise<Response>;
+	private serverName: string;
+	private serverVersion: string;
+	private mcpMeta: Map<string, ToolMeta>;
+
+	constructor(
+		router: RouterType<any, any[], any>,
+		base: string,
+		fetchHandler: (request: IRequest, ctx?: any) => Promise<Response>,
+		mcpMeta: Map<string, ToolMeta>,
+		options?: MCPOptions,
+	) {
+		this.router = router;
+		this.base = base;
+		this.fetchHandler = fetchHandler;
+		this.mcpMeta = mcpMeta;
+		this.serverName = options?.name ?? 'MCP Server';
+		this.serverVersion = options?.version ?? '1.0.0';
+	}
+
+	public toolNameFromRoute(method: string, path: string): string {
+		let name = path;
+		// Strip base path
+		if (this.base && name.startsWith(this.base)) {
+			name = name.slice(this.base.length);
+		}
+		// Remove leading slash
+		name = name.replace(/^\//, '');
+		// Replace :param with "by_param"
+		name = name.replace(/:(\w+)/g, 'by_$1');
+		// Replace slashes with underscores
+		name = name.replace(/\//g, '_');
+		// Prepend method
+		name = `${method.toLowerCase()}_${name}`;
+		// Clean up double underscores
+		name = name.replace(/_+/g, '_').replace(/_$/, '');
+		return name;
+	}
+
+	public inferQueryParams(handlers: Function[]): string[] {
+		const params = new Set<string>();
+		for (const handler of handlers) {
+			try {
+				const src = handler.toString();
+				// Match req.query.paramName, request.query.paramName, query.paramName
+				const dotPattern = /(?:req(?:uest)?\.)?query\.(\w+)/g;
+				let match: RegExpExecArray | null;
+				while ((match = dotPattern.exec(src)) !== null) {
+					params.add(match[1]);
+				}
+				// Match req.query['paramName'] or req.query["paramName"]
+				const bracketPattern = /(?:req(?:uest)?\.)?query\[['"](\w+)['"]\]/g;
+				while ((match = bracketPattern.exec(src)) !== null) {
+					params.add(match[1]);
+				}
+			} catch {
+				// handler.toString() may fail for native code
+			}
+		}
+		return Array.from(params);
+	}
+
+	public introspectRoutes(): ToolDefinition[] {
+		const routes: any[] = (this.router as any).routes ?? [];
+		const tools: ToolDefinition[] = [];
+
+		for (const route of routes) {
+			// itty-router v5 stores routes as [method, regex, handlers[], path]
+			const [method, , handlers, originalPath] = route;
+
+			// Skip wildcard catch-alls and OPTIONS
+			if (!originalPath || originalPath === '*' || originalPath.endsWith('/*')) continue;
+			if (method === 'OPTIONS' || method === 'ALL') continue;
+
+			const toolName = this.toolNameFromRoute(method, originalPath);
+			const metaKey = `${method}:${originalPath}`;
+			const meta = this.mcpMeta.get(metaKey);
+
+			const properties: Record<string, any> = {};
+			const required: string[] = [];
+
+			// Extract path params
+			const paramPattern = /:(\w+)/g;
+			let match: RegExpExecArray | null;
+			while ((match = paramPattern.exec(originalPath)) !== null) {
+				const paramName = match[1];
+				properties[paramName] = {
+					type: meta?.params?.[paramName]?.type ?? 'string',
+					...(meta?.params?.[paramName]?.description && { description: meta.params[paramName].description }),
+				};
+				required.push(paramName);
+			}
+
+			// POST/PUT/PATCH get a body property
+			if (['POST', 'PUT', 'PATCH'].includes(method)) {
+				properties['body'] = {
+					type: 'object',
+					description: meta?.params?.['body']?.description ?? 'Request body',
+				};
+			}
+
+			// Infer query params for GET/DELETE
+			if (['GET', 'DELETE'].includes(method)) {
+				const queryParams = this.inferQueryParams(handlers);
+				for (const qp of queryParams) {
+					if (!properties[qp]) {
+						properties[qp] = {
+							type: meta?.params?.[qp]?.type ?? 'string',
+							...(meta?.params?.[qp]?.description && { description: meta.params[qp].description }),
+						};
+					}
+				}
+			}
+
+			const description = meta?.description ?? `${method} ${originalPath}`;
+
+			tools.push({
+				name: toolName,
+				description,
+				inputSchema: {
+					type: 'object',
+					properties,
+					required,
+				},
+			});
+		}
+
+		return tools;
+	}
+
+	private findRoute(toolName: string): { method: string; path: string; handlers: Function[] } | null {
+		const routes: any[] = (this.router as any).routes ?? [];
+		for (const route of routes) {
+			const [method, , handlers, originalPath] = route;
+			if (!originalPath || originalPath === '*' || originalPath.endsWith('/*')) continue;
+			if (method === 'OPTIONS' || method === 'ALL') continue;
+			if (this.toolNameFromRoute(method, originalPath) === toolName) {
+				return { method, path: originalPath, handlers };
+			}
+		}
+		return null;
+	}
+
+	public async callTool(name: string, args: Record<string, any> = {}): Promise<any> {
+		const route = this.findRoute(name);
+		if (!route) {
+			return { isError: true, content: [{ type: 'text', text: `Unknown tool: ${name}` }] };
+		}
+
+		const { method, path } = route;
+
+		// Build URL with path params substituted
+		let url = path;
+		const pathParamPattern = /:(\w+)/g;
+		let match: RegExpExecArray | null;
+		while ((match = pathParamPattern.exec(path)) !== null) {
+			const paramName = match[1];
+			if (args[paramName] != null) {
+				url = url.replace(`:${paramName}`, encodeURIComponent(String(args[paramName])));
+			}
+		}
+
+		// Build query string for non-path, non-body params
+		const pathParams = new Set<string>();
+		const ppPattern = /:(\w+)/g;
+		let m: RegExpExecArray | null;
+		while ((m = ppPattern.exec(path)) !== null) pathParams.add(m[1]);
+
+		const queryParams: string[] = [];
+		for (const [key, value] of Object.entries(args)) {
+			if (key === 'body' || pathParams.has(key)) continue;
+			queryParams.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+		}
+		if (queryParams.length > 0) {
+			url += '?' + queryParams.join('&');
+		}
+
+		const fullUrl = `http://localhost${url}`;
+		const requestInit: RequestInit = { method };
+		if (args.body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+			requestInit.body = JSON.stringify(args.body);
+			requestInit.headers = { 'Content-Type': 'application/json' };
+		}
+
+		const request = new Request(fullUrl, requestInit);
+
+		try {
+			const response = await this.fetchHandler(request as any);
+			const text = await response.text();
+			let content: any;
+			try {
+				content = JSON.parse(text);
+			} catch {
+				content = text;
+			}
+			return {
+				content: [{ type: 'text', text: typeof content === 'string' ? content : JSON.stringify(content) }],
+			};
+		} catch (err: any) {
+			return {
+				isError: true,
+				content: [{ type: 'text', text: err?.message ?? String(err) }],
+			};
+		}
+	}
+
+	public async handleJsonRpc(message: JsonRpcRequest): Promise<any> {
+		const { method, id, params } = message;
+
+		switch (method) {
+			case 'initialize':
+				return {
+					jsonrpc: '2.0',
+					id,
+					result: {
+						protocolVersion: '2024-11-05',
+						capabilities: { tools: { listChanged: true } },
+						serverInfo: { name: this.serverName, version: this.serverVersion },
+					},
+				};
+
+			case 'notifications/initialized':
+				// No response needed for notifications
+				return null;
+
+			case 'tools/list':
+				return {
+					jsonrpc: '2.0',
+					id,
+					result: { tools: this.introspectRoutes() },
+				};
+
+			case 'tools/call': {
+				const result = await this.callTool(params?.name, params?.arguments ?? {});
+				return {
+					jsonrpc: '2.0',
+					id,
+					result,
+				};
+			}
+
+			default:
+				return {
+					jsonrpc: '2.0',
+					id,
+					error: { code: -32601, message: `Method not found: ${method}` },
+				};
+		}
+	}
+
+	public httpHandler = async (request: Request): Promise<Response> => {
+		if (request.method === 'GET') {
+			// SSE endpoint for server-sent events (Streamable HTTP)
+			const stream = new ReadableStream({
+				start(controller) {
+					const encoder = new TextEncoder();
+					controller.enqueue(encoder.encode(`event: endpoint\ndata: /mcp\n\n`));
+					// Keep connection open - client will close
+				},
+			});
+			return new Response(stream, {
+				headers: {
+					'Content-Type': 'text/event-stream',
+					'Cache-Control': 'no-cache',
+					'Connection': 'keep-alive',
+				},
+			});
+		}
+
+		// POST: JSON-RPC request
+		try {
+			const body = await request.json() as JsonRpcRequest;
+			const result = await this.handleJsonRpc(body);
+			if (result === null) {
+				return new Response(null, { status: 204 });
+			}
+			return new Response(JSON.stringify(result), {
+				headers: { 'Content-Type': 'application/json' },
+			});
+		} catch (err: any) {
+			return new Response(JSON.stringify({
+				jsonrpc: '2.0',
+				id: null,
+				error: { code: -32700, message: 'Parse error' },
+			}), {
+				status: 400,
+				headers: { 'Content-Type': 'application/json' },
+			});
+		}
+	};
+
+	public async serveStdio(): Promise<void> {
+		const stdin = (globalThis as any).process.stdin;
+		const stdout = (globalThis as any).process.stdout;
+
+		stdin.setEncoding('utf8');
+
+		let buffer = '';
+		stdin.on('data', async (chunk: string) => {
+			buffer += chunk;
+			// Process complete lines
+			const lines = buffer.split('\n');
+			buffer = lines.pop() ?? '';
+
+			for (const line of lines) {
+				const trimmed = line.trim();
+				if (!trimmed) continue;
+				try {
+					const message = JSON.parse(trimmed) as JsonRpcRequest;
+					const result = await this.handleJsonRpc(message);
+					if (result !== null) {
+						stdout.write(JSON.stringify(result) + '\n');
+					}
+				} catch {
+					stdout.write(JSON.stringify({
+						jsonrpc: '2.0',
+						id: null,
+						error: { code: -32700, message: 'Parse error' },
+					}) + '\n');
+				}
+			}
+		});
+	}
+}

package/src/modules/RouterWrapper.ts

@@ -1,6 +1,7 @@
 import { libx } from 'libx.js/build/bundles/essentials.js';
 import { Route, Router, RouterType, error, json, cors, withParams, IRequest, text, ResponseHandler } from 'itty-router';
 import { createServerAdapter } from '@whatwg-node/server';
+import { MCPAdapter, MCPOptions } from './MCPAdapter';
 
 type BaseRouterInitializer = (string) => { base: string; router: RouterType<IRequest, any[]> };
 type CorsOptions = Parameters<typeof cors>[0];
@@ -9,6 +10,7 @@ export class RouterWrapper<TCtx = any> {
 	private cors: ReturnType<typeof cors>;
 	private preflight: (request: Request) => Response | Promise<Response>;
 	private corsify: (response: Response, request: Request) => Response | Promise<Response>;
+	private mcpMeta: Map<string, { description?: string; params?: Record<string, { description?: string; type?: string }> }> = new Map();
 
 	public constructor(
 		public base: string,
@@ -66,4 +68,19 @@ export class RouterWrapper<TCtx = any> {
 		const ittyServer = createServerAdapter(this.fetchHandler.bind(this));
 		return ittyServer;
 	}
+
+	public describeMCP(path: string, method: string, meta: { description?: string; params?: Record<string, { description?: string; type?: string }> }) {
+		const key = `${method.toUpperCase()}:${this.base}${path}`;
+		this.mcpMeta.set(key, meta);
+	}
+
+	public asMCP(options?: MCPOptions): MCPAdapter {
+		return new MCPAdapter(
+			this.router,
+			this.base,
+			this.fetchHandler.bind(this),
+			this.mcpMeta,
+			options,
+		);
+	}
 }