@webda/mcp 0.0.0-stage → 4.0.0-beta.3

package/lib/mcpservice.service.js

@@ -0,0 +1,463 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Command, OperationsTransport, OperationsTransportParameters, Session, useApplication, useService } from "@webda/core";
+import { AsyncResource } from "node:async_hooks";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { useLog } from "@webda/workout";
+import { randomUUID } from "node:crypto";
+import { Writable } from "node:stream";
+import { SessionAuthenticator } from "./auth.js";
+import { jsonRpcError, toRequest, writeResponse } from "./bridge.js";
+import { ResourceRegistry } from "./resources.js";
+import { createMcpServer } from "./server.js";
+import { McpSessionManager } from "./sessions.js";
+import { operationsFingerprint, ToolRegistry } from "./tools.js";
+/**
+ * Parameters for the MCP transport
+ */
+export class McpServiceParameters extends OperationsTransportParameters {
+    /**
+     * HTTP endpoint; false disables HTTP (stdio only)
+     * @default "/mcp"
+     */
+    url;
+    /**
+     * Models exposed as resources (short ids or "*"); false disables resources
+     * @default {"models":["*"]}
+     */
+    resources;
+    /**
+     * Seconds of inactivity before an MCP session is evicted
+     * @default 1800
+     */
+    sessionTimeout;
+    /**
+     * Extra Origin values accepted besides the request's own origin
+     * @default []
+     */
+    allowedOrigins;
+    /**
+     * Hostnames (any port) accepted in the request Host, against DNS rebinding;
+     * "*" disables the check
+     * @default ["localhost","127.0.0.1","::1"]
+     */
+    allowedHosts;
+    /**
+     * Maximum number of concurrent MCP HTTP sessions; at the limit the least
+     * recently used session is closed to make room for a new one
+     * @default 1000
+     */
+    maxSessions;
+    /**
+     * Larger tool/resource outputs are truncated
+     * @default 1048576
+     */
+    maxOutputBytes;
+    /**
+     * Server name announced to clients (defaults to the application package name)
+     */
+    serverName;
+    /**
+     * Server version announced to clients (defaults to the application package version)
+     */
+    serverVersion;
+    /**
+     * stdio defaults
+     */
+    stdio;
+    /**
+     * Name of a service implementing McpAuthenticator; default uses the Webda session
+     */
+    authenticator;
+    /**
+     * @param params - raw parameters
+     * @returns this with defaults applied
+     */
+    load(params = {}) {
+        super.load(params);
+        this.url ??= "/mcp";
+        this.resources ??= { models: ["*"] };
+        if (this.resources) {
+            this.resources.models ??= ["*"];
+        }
+        this.sessionTimeout ??= 1800;
+        this.allowedOrigins ??= [];
+        this.allowedHosts ??= ["localhost", "127.0.0.1", "::1"];
+        this.maxSessions ??= 1000;
+        this.maxOutputBytes ??= 1048576;
+        this.stdio ??= {};
+        return this;
+    }
+}
+/**
+ * Reserve stdout for the MCP protocol: every other write to `stdout` (log lines,
+ * whatever `--log-stream` says, unpatched console calls, third-party output) is
+ * sent to `stderr`, and the returned stream writes to the real stdout.
+ * @param stdout - stream carrying protocol frames
+ * @param stderr - stream receiving everything else
+ * @returns the protocol stream and a function restoring stdout
+ */
+export function reserveStdout(stdout = process.stdout, stderr = process.stderr) {
+    const original = stdout.write;
+    const write = original.bind(stdout);
+    const protocol = new Writable({
+        write(chunk, encoding, callback) {
+            if (write(chunk, encoding)) {
+                callback();
+            }
+            else {
+                stdout.once("drain", () => callback());
+            }
+        }
+    });
+    stdout.write = stderr.write.bind(stderr);
+    return {
+        protocol,
+        restore: () => {
+            stdout.write = original;
+        }
+    };
+}
+/**
+ * MCP transport: exposes operations as Model Context Protocol tools and
+ * models as resources, over Streamable HTTP (a Webda route) and stdio (`webda mcp`).
+ *
+ * @WebdaModda
+ */
+let McpService = (() => {
+    let _classSuper = OperationsTransport;
+    let _instanceExtraInitializers = [];
+    let _mcp_decorators;
+    return class McpService extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _mcp_decorators = [Command("mcp", { description: "Serve operations as MCP tools over stdio", requires: ["mcp"] })];
+            __esDecorate(this, null, _mcp_decorators, { kind: "method", name: "mcp", static: false, private: false, access: { has: obj => "mcp" in obj, get: obj => obj.mcp }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        tools = __runInitializers(this, _instanceExtraInitializers);
+        resourceRegistry;
+        sessions;
+        fingerprint = "";
+        authenticator;
+        evictTimer;
+        stdioServers = [];
+        /**
+         * Build typed parameters with defaults. Application replaces this with the
+         * webda.module.json `Configuration` class (the same McpServiceParameters);
+         * it is defined here so the service also works when registered by hand.
+         * @param params - raw parameters
+         * @returns typed parameters
+         */
+        static createConfiguration(params = {}) {
+            return new McpServiceParameters().load(params);
+        }
+        /**
+         * Tools are built in bulk by refreshRegistries
+         * @param _operationId - unused
+         * @param _definition - unused
+         */
+        exposeOperation(_operationId, _definition) { }
+        /**
+         * @returns this once the authenticator is resolved
+         */
+        resolve() {
+            super.resolve();
+            if (this.parameters.authenticator) {
+                const service = useService(this.parameters.authenticator);
+                if (typeof service?.authenticate !== "function") {
+                    throw new Error(`MCP authenticator '${this.parameters.authenticator}' must implement authenticate(ctx)`);
+                }
+                this.authenticator = service;
+            }
+            else {
+                this.authenticator = new SessionAuthenticator();
+            }
+            return this;
+        }
+        /**
+         * Build registries, mount the HTTP route and start session eviction
+         * @returns this
+         */
+        async init() {
+            await super.init();
+            const resolve = (name) => {
+                try {
+                    return useApplication().getSchema(name);
+                }
+                catch {
+                    return undefined;
+                }
+            };
+            this.tools = new ToolRegistry(resolve);
+            this.resourceRegistry = this.parameters.resources
+                ? new ResourceRegistry(this.parameters.resources.models)
+                : undefined;
+            this.sessions = new McpSessionManager(this.parameters.sessionTimeout * 1000);
+            this.refreshRegistries();
+            if (this.parameters.url !== false) {
+                this.addRoute(this.parameters.url, ["GET", "POST", "DELETE"], this.handleHttp, { hidden: true });
+            }
+            this.evictTimer = setInterval(() => void this.sessions.evictIdle(), 60_000);
+            this.evictTimer.unref();
+            return this;
+        }
+        /**
+         * Rebuild tool and resource registries when operations changed
+         * @returns true when they were rebuilt
+         */
+        refreshRegistries() {
+            const ops = this.getOperations();
+            const fingerprint = operationsFingerprint(ops);
+            if (fingerprint === this.fingerprint) {
+                return false;
+            }
+            this.fingerprint = fingerprint;
+            this.tools.build(ops);
+            this.resourceRegistry?.build(ops);
+            return true;
+        }
+        /**
+         * Detect runtime operation registration and notify open sessions
+         */
+        checkForChanges() {
+            if (!this.refreshRegistries()) {
+                return;
+            }
+            const servers = [...this.sessions.all().map(e => e.server), ...this.stdioServers];
+            for (const server of servers) {
+                server.sendToolListChanged().catch(err => useLog("DEBUG", "tools/list_changed not delivered", err));
+            }
+        }
+        /**
+         * @param getSession - caller session resolution
+         * @returns a new SDK server over this service's registries
+         */
+        createServer(getSession) {
+            const pkg = useApplication().getPackageDescription?.() || {};
+            return createMcpServer({
+                info: {
+                    name: this.parameters.serverName ?? pkg.name ?? "webda",
+                    version: this.parameters.serverVersion ?? pkg.version ?? "0.0.0"
+                },
+                tools: this.tools,
+                resources: this.resourceRegistry,
+                maxOutputBytes: this.parameters.maxOutputBytes,
+                getSession,
+                beforeRequest: () => this.checkForChanges()
+            });
+        }
+        /**
+         * Origin (protocol + host[:port]) of a request, from the `x-forwarded-host` header
+         * when present (HttpServer rejects forwarded headers from untrusted sources) or
+         * the `host` header. Parsed here rather than via HttpContext.getAbsoluteUrl,
+         * which cannot represent IPv6 literals like `[::1]:18080`.
+         * @param ctx - the request context
+         * @returns the parsed origin, or undefined when the host is missing or invalid
+         */
+        requestOrigin(ctx) {
+            const http = ctx.getHttpContext();
+            const host = (http.getUniqueHeader("x-forwarded-host") || http.getUniqueHeader("host") || "").split(",")[0].trim();
+            // a Host header is only host[:port]: reject anything that smuggles a path, credentials, etc.
+            if (!host || /[/\\@?#\s]/.test(host)) {
+                return undefined;
+            }
+            try {
+                return new URL(`${http.getProtocol() || "http:"}//${host}`);
+            }
+            catch {
+                return undefined;
+            }
+        }
+        /**
+         * DNS-rebinding guard: the request hostname must be in allowedHosts
+         * @param ctx - the request context
+         * @returns true when the host is accepted
+         */
+        isHostAllowed(ctx) {
+            const allowed = this.parameters.allowedHosts;
+            if (allowed.includes("*")) {
+                return true;
+            }
+            const origin = this.requestOrigin(ctx);
+            if (!origin) {
+                return false;
+            }
+            const hostname = origin.hostname.replace(/^\[(.*)\]$/, "$1").toLowerCase();
+            return allowed.some(h => h.replace(/^\[(.*)\]$/, "$1").toLowerCase() === hostname);
+        }
+        /**
+         * Handle GET/POST/DELETE on the MCP endpoint
+         * @param ctx - the request context
+         */
+        async handleHttp(ctx) {
+            const http = ctx.getHttpContext();
+            const origin = this.requestOrigin(ctx);
+            if (!this.isHostAllowed(ctx)) {
+                jsonRpcError(ctx, 403, -32000, "Host not allowed");
+                return;
+            }
+            const session = await this.authenticator.authenticate(ctx);
+            const userId = session?.userId;
+            const body = http.getMethod() === "POST" ? await ctx.getRawInputAsString() : undefined;
+            let parsedBody;
+            if (body) {
+                try {
+                    parsedBody = JSON.parse(body);
+                }
+                catch {
+                    // left undefined: the SDK transport parses the raw body and answers with a parse error
+                }
+            }
+            const sessionId = http.getUniqueHeader("mcp-session-id");
+            let entry;
+            if (sessionId) {
+                entry = this.sessions.get(sessionId);
+                if (!entry) {
+                    jsonRpcError(ctx, 404, -32001, "Session not found");
+                    return;
+                }
+                if (entry.userId !== userId) {
+                    jsonRpcError(ctx, 403, -32000, "Session belongs to another user");
+                    return;
+                }
+            }
+            else {
+                const initializing = Array.isArray(parsedBody)
+                    ? parsedBody.some(m => isInitializeRequest(m))
+                    : isInitializeRequest(parsedBody);
+                if (!initializing && parsedBody !== undefined) {
+                    jsonRpcError(ctx, 400, -32000, "Bad Request: Mcp-Session-Id header is required");
+                    return;
+                }
+                // At the cap, make room by evicting the least recently used session:
+                // refusing new sessions would let anonymous callers lock out the endpoint
+                while (this.sessions.all().length >= Math.max(1, this.parameters.maxSessions)) {
+                    const evicted = await this.sessions.evictOldest();
+                    useLog("INFO", "MCP session limit reached, evicted least recently used session", evicted);
+                }
+                entry = await this.createHttpSession(ctx, userId, origin);
+            }
+            this.checkForChanges();
+            const authInfo = { token: "", clientId: userId ?? "anonymous", scopes: [], extra: { session } };
+            const response = await entry.transport.handleRequest(toRequest(ctx, body, origin), {
+                parsedBody,
+                authInfo
+            });
+            await writeResponse(ctx, response);
+        }
+        /**
+         * Create an SDK server + transport pair for a new MCP session
+         * @param ctx - the initializing request
+         * @param userId - caller user id
+         * @param requestOrigin - origin of the request (see requestOrigin)
+         * @returns the (not yet registered) session entry; it registers on initialize
+         */
+        async createHttpSession(ctx, userId, requestOrigin = this.requestOrigin(ctx)) {
+            const origin = requestOrigin?.origin;
+            const entry = { id: "", userId, lastSeen: Date.now(), server: undefined, transport: undefined };
+            const transport = new WebStandardStreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                enableDnsRebindingProtection: true,
+                allowedOrigins: [...(origin ? [origin] : []), ...this.parameters.allowedOrigins],
+                onsessioninitialized: id => {
+                    entry.id = id;
+                    this.sessions.add(entry);
+                },
+                onsessionclosed: id => this.sessions.remove(id)
+            });
+            entry.transport = transport;
+            entry.server = this.createServer(extra => extra.authInfo?.extra?.session);
+            await entry.server.connect(transport);
+            return entry;
+        }
+        /**
+         * Serve the MCP tools over stdio until stdin closes
+         *
+         * Anyone able to start this command acts with `user`'s permissions
+         * (or anonymous permissions when no user is given).
+         *
+         * @param user - user id whose permissions apply
+         */
+        async mcp(user = "") {
+            // stdout carries only protocol frames: logging goes to stderr regardless of --log-stream
+            const { protocol, restore } = reserveStdout();
+            try {
+                const server = await this.serveStdio(new StdioServerTransport(process.stdin, protocol), user || this.parameters.stdio.user);
+                await new Promise(resolve => {
+                    server.onclose = () => resolve();
+                    process.stdin.once("end", () => void server.close());
+                });
+            }
+            finally {
+                restore();
+            }
+        }
+        /**
+         * Connect a new MCP server to a transport, acting as `user`
+         * @param transport - stdio (or any) transport
+         * @param user - user id whose permissions apply; anonymous when empty
+         * @returns the connected server
+         */
+        async serveStdio(transport, user) {
+            const session = new Session();
+            if (user) {
+                session.login(user, user);
+            }
+            const server = this.createServer(() => session);
+            this.stdioServers.push(server);
+            await server.connect(transport);
+            // Stream events (stdin) fire outside the instance storage: rebind the handlers to the current async context
+            if (transport.onmessage) {
+                transport.onmessage = AsyncResource.bind(transport.onmessage);
+            }
+            return server;
+        }
+        /**
+         * Stop eviction and close every MCP session
+         */
+        async stop() {
+            clearInterval(this.evictTimer);
+            await this.sessions?.closeAll();
+            await Promise.all(this.stdioServers.map(s => s.close().catch(() => { })));
+            this.stdioServers = [];
+            await super.stop();
+        }
+    };
+})();
+export { McpService };
+//# sourceMappingURL=mcpservice.service.js.map

package/lib/mcpservice.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpservice.service.js","sourceRoot":"","sources":["../src/mcpservice.service.ts"],"names":[],"mappings":"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"}

package/lib/resources.d.ts

@@ -0,0 +1,86 @@
+import type { OperationDefinition } from "@webda/core";
+import type { ResourceTemplate } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * A model exposed as MCP resources
+ */
+export interface ResourceModel {
+    /**
+     * Short model id as used in operation ids, e.g. "Post"
+     */
+    name: string;
+    /**
+     * Operation returning one instance, e.g. "Post.Get"
+     */
+    getOperationId: string;
+    /**
+     * Operation listing instances, e.g. "Posts.Query"
+     */
+    queryOperationId?: string;
+    /**
+     * Primary key fields, in URI order
+     */
+    pkFields: string[];
+}
+/**
+ * Registry of models exposed as `webda://{Model}/{pk...}` resources
+ */
+export declare class ResourceRegistry {
+    protected filter: string[];
+    protected entries: ResourceModel[];
+    /**
+     * @param filter - model short ids to expose, or ["*"]
+     */
+    constructor(filter: string[]);
+    /**
+     * Rebuild from operations: every visible `{Model}.Get` with `context.pkFields`
+     * becomes a model; its `.Query` operation shares the same `context.model`.
+     * @param ops - visible operations
+     */
+    build(ops: Record<string, OperationDefinition>): void;
+    /**
+     * @returns exposed models, sorted by name
+     */
+    models(): ResourceModel[];
+    /**
+     * @returns MCP resource templates
+     */
+    templates(): ResourceTemplate[];
+    /**
+     * @param model - the model
+     * @param record - an instance (or key object)
+     * @returns its resource URI
+     */
+    uriFor(model: ResourceModel, record: Record<string, unknown>): string;
+    /**
+     * @param uri - a resource URI
+     * @returns the model and decoded key, or undefined when it does not match
+     */
+    parse(uri: string): {
+        model: ResourceModel;
+        key: Record<string, string>;
+    } | undefined;
+}
+/**
+ * @param cursor - model and continuation token
+ * @param cursor.model - model short id
+ * @param cursor.token - continuation token of that model's query
+ * @returns opaque cursor
+ */
+export declare function encodeCursor(cursor: {
+    model: string;
+    token?: string;
+}): string;
+/**
+ * @param cursor - opaque cursor
+ * @returns the decoded cursor, or undefined when absent or invalid
+ */
+export declare function decodeCursor(cursor: string | undefined): {
+    model: string;
+    token?: string;
+} | undefined;
+/**
+ * @param token - continuation token
+ * @returns the WebdaQL query for one page
+ */
+export declare function queryFor(token?: string): string;
+//# sourceMappingURL=resources.d.ts.map

package/lib/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;GAEG;AACH,qBAAa,gBAAgB;IAMf,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE;IALtC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,CAAM;IAExC;;OAEG;IACH,YAAsB,MAAM,EAAE,MAAM,EAAE,EAAI;IAE1C;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,IAAI,CAkBpD;IAED;;OAEG;IACH,MAAM,IAAI,aAAa,EAAE,CAExB;IAED;;OAEG;IACH,SAAS,IAAI,gBAAgB,EAAE,CAM9B;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpE;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAgBpF;CACF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE9E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAgBtG;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/C"}