@utdk/mcp 0.1.0-dev.646adf4

package/dist/loader.js

@@ -0,0 +1,211 @@
+/**
+ * Dynamic provider loader for @utdk/mcp-server.
+ *
+ * Loads OpenAPI documents and auth configuration from @utdk/* provider packages.
+ * Converts each OpenAPI spec to MCP-compatible tool definitions using OpenApiConverter.
+ */
+import { OpenApiConverter } from "@utcp/http";
+import { withSpan, configureTelemetry } from "@utdk/common";
+import { buildAuthProvider } from "./auth.js";
+/**
+ * Extract path parameter keys from a route template like "/repos/{owner}/{repo}".
+ */
+function extractPathParams(routeTemplate) {
+    const matches = routeTemplate.match(/\{([^}]+)\}/g) ?? [];
+    return matches.map((m) => m.slice(1, -1));
+}
+/**
+ * Convert a UTCP tool name to a safe MCP tool name.
+ * MCP tool names must match [a-zA-Z0-9_-]+ .
+ * e.g. "github.repos/list" → "github__repos_list"
+ */
+function toMcpToolName(utcpName) {
+    return utcpName.replace(/\./g, "__").replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+/**
+ * Load a provider package's OpenAPI document and package metadata.
+ * Returns null if the package cannot be found or loaded.
+ */
+async function loadProviderPackage(providerName) {
+    const packageName = `@utdk/${providerName}`;
+    try {
+        // Dynamically import the provider's openapi.json via the package path
+        // Provider packages expose their openapi.json as a JSON import
+        const [openApiMod, pkgMod] = await Promise.all([
+            import(`${packageName}/openapi.json`, { with: { type: "json" } }).catch(() => null),
+            import(`${packageName}/package.json`, { with: { type: "json" } }).catch(() => null),
+        ]);
+        if (!openApiMod || !pkgMod) {
+            // Try loading the whole package and see if it exposes the doc
+            process.stderr.write(`[mcp-server] Warning: could not import openapi.json or package.json for ${packageName}\n`);
+            return null;
+        }
+        return {
+            openApiDoc: openApiMod.default,
+            packageJson: pkgMod.default,
+        };
+    }
+    catch (err) {
+        process.stderr.write(`[mcp-server] Warning: failed to load provider ${providerName}: ${err}\n`);
+        return null;
+    }
+}
+/**
+ * Convert a loaded provider's OpenAPI doc into MCP-ready tool definitions.
+ */
+function buildProviderTools(providerName, openApiDoc, auth) {
+    const converter = new OpenApiConverter(openApiDoc, {
+        callTemplateName: providerName,
+    });
+    const manual = converter.convert();
+    const tools = [];
+    for (const tool of manual.tools) {
+        const template = tool.tool_call_template;
+        if (!template)
+            continue;
+        const routeTemplate = template.url ?? "/";
+        const method = (template.http_method ?? "GET").toUpperCase();
+        const contentType = template.content_type ?? "application/json";
+        const pathParamKeys = extractPathParams(routeTemplate);
+        // Determine which input properties go in query params vs body
+        // For GET/HEAD/DELETE, non-path params → query string
+        // For POST/PUT/PATCH, non-path params → body
+        const inputProperties = (tool.inputs?.properties ?? {});
+        const allInputKeys = Object.keys(inputProperties);
+        const isBodyMethod = ["POST", "PUT", "PATCH"].includes(method);
+        const queryParamKeys = isBodyMethod ? [] : allInputKeys.filter((k) => !pathParamKeys.includes(k));
+        tools.push({
+            mcpName: toMcpToolName(tool.name),
+            utcpName: tool.name,
+            description: tool.description ?? `${method} ${routeTemplate}`,
+            inputSchema: tool.inputs,
+            providerName,
+            tags: tool.tags ?? [],
+            method,
+            routeTemplate,
+            contentType,
+            pathParamKeys,
+            queryParamKeys,
+            auth,
+        });
+    }
+    return tools;
+}
+/**
+ * Load all tools for a list of provider names.
+ * Providers that fail to load are skipped with a warning.
+ */
+export async function loadProviders(providerNames) {
+    const allTools = [];
+    await Promise.all(providerNames.map(async (providerName) => {
+        const pkg = await loadProviderPackage(providerName);
+        if (!pkg)
+            return;
+        const authConfigs = pkg.packageJson.utdk?.auth ?? [];
+        const auth = buildAuthProvider(providerName, authConfigs);
+        const tools = buildProviderTools(providerName, pkg.openApiDoc, auth);
+        process.stderr.write(`[mcp-server] Loaded ${tools.length} tools from @utdk/${providerName}\n`);
+        allTools.push(...tools);
+    }));
+    return allTools;
+}
+/**
+ * Parse the UTDK_PROVIDERS environment variable.
+ * Returns an array of provider names (e.g. ["github", "slack", "stripe"]).
+ */
+export function parseProviderNames(envValue) {
+    if (!envValue?.trim())
+        return [];
+    return envValue
+        .split(",")
+        .map((name) => name.trim().toLowerCase())
+        .filter(Boolean);
+}
+/**
+ * Initialize telemetry if UTDK_OTEL_EXPORTER is set.
+ */
+export async function initTelemetry() {
+    const exporter = process.env["UTDK_OTEL_EXPORTER"];
+    if (exporter === "otlp" || exporter === "console") {
+        await configureTelemetry({ enabled: true, exporter });
+    }
+}
+/**
+ * Execute a tool call with telemetry and auth.
+ */
+export async function executeTool(tool, args) {
+    return withSpan({
+        provider: tool.providerName,
+        operation: tool.utcpName,
+        spanName: `utdk.mcp.tool_call`,
+    }, async (span) => {
+        span.setAttribute("utdk.provider", tool.providerName);
+        span.setAttribute("utdk.tool", tool.utcpName);
+        span.setAttribute("mcp.tool_name", tool.mcpName);
+        // Build URL by substituting path parameters
+        let url = tool.routeTemplate;
+        const remainingArgs = { ...args };
+        for (const pathKey of tool.pathParamKeys) {
+            const value = remainingArgs[pathKey];
+            if (value !== undefined) {
+                url = url.replace(`{${pathKey}}`, encodeURIComponent(String(value)));
+                delete remainingArgs[pathKey];
+            }
+            else {
+                url = url.replace(`{${pathKey}}`, "");
+            }
+        }
+        // Build query string for GET-style methods
+        const isBodyMethod = ["POST", "PUT", "PATCH"].includes(tool.method);
+        let body;
+        const requestHeaders = {
+            "Content-Type": tool.contentType,
+            "User-Agent": "@utdk/mcp-server/0.1.0",
+        };
+        if (isBodyMethod) {
+            const bodyObj = {};
+            for (const [k, v] of Object.entries(remainingArgs)) {
+                bodyObj[k] = v;
+            }
+            if (Object.keys(bodyObj).length > 0) {
+                body = JSON.stringify(bodyObj);
+            }
+        }
+        else {
+            // Query params
+            const urlObj = new URL(url);
+            for (const [k, v] of Object.entries(remainingArgs)) {
+                if (v !== undefined && v !== null) {
+                    urlObj.searchParams.append(k, String(v));
+                }
+            }
+            url = urlObj.toString();
+        }
+        // Apply auth
+        if (tool.auth) {
+            await tool.auth.authenticate(requestHeaders);
+        }
+        span.setAttribute("http.method", tool.method);
+        span.setAttribute("http.url", url);
+        const response = await fetch(url, {
+            method: tool.method,
+            headers: requestHeaders,
+            body,
+        });
+        span.setAttribute("http.status_code", response.status);
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`Tool call failed: ${response.status} ${response.statusText}${errorBody ? `\n${errorBody}` : ""}`);
+        }
+        // Parse response
+        if (response.status === 204 || response.status === 205) {
+            return null;
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("json")) {
+            return response.json();
+        }
+        return response.text();
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/search.js

@@ -0,0 +1,143 @@
+/**
+ * Search and tokenization utilities for the MCP server wrapper tools.
+ *
+ * Extracted into a separate module so they can be unit-tested without
+ * importing the full server entry-point (which starts stdio transport).
+ */
+// ---------------------------------------------------------------------------
+// Tokenization
+// ---------------------------------------------------------------------------
+/**
+ * Tokenize text into lowercase words, splitting on non-alphanumeric characters.
+ * Also splits camelCase boundaries for better matching of MCP tool names.
+ *
+ * Examples:
+ *   "github__repos_list" → ["github", "repos", "list"]
+ *   "List public repositories" → ["list", "public", "repositories"]
+ *   "security-advisories" → ["security", "advisories"]
+ */
+export function tokenize(text) {
+    return text
+        .replace(/([a-z])([A-Z])/g, "$1 $2") // split camelCase boundaries
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
+// ---------------------------------------------------------------------------
+// TF-IDF scoring
+// ---------------------------------------------------------------------------
+/**
+ * Build a TF-IDF scoring function over a corpus of tools.
+ *
+ * Field weights applied during term-frequency calculation:
+ *   - name  × 3   (most signal)
+ *   - tags  × 2   (category signal)
+ *   - description × 1
+ *
+ * IDF formula: log((N + 1) / df)  — smoothed to avoid division-by-zero.
+ *
+ * Returns a function `score(tool, queryWords) → number` that can be called
+ * for each candidate. Build once per search call, reuse across candidates.
+ */
+export function buildTfIdf(tools) {
+    const N = tools.length;
+    if (N === 0)
+        return () => 0;
+    // Precompute weighted token bags for each tool
+    const bags = tools.map((tool) => {
+        const bag = new Map();
+        const add = (tokens, weight) => {
+            for (const tok of tokens) {
+                bag.set(tok, (bag.get(tok) ?? 0) + weight);
+            }
+        };
+        add(tokenize(tool.mcpName), 3);
+        for (const tag of tool.tags) {
+            add(tokenize(tag), 2);
+        }
+        add(tokenize(tool.description), 1);
+        return bag;
+    });
+    // Document frequency: how many tools contain each token
+    const df = new Map();
+    for (const bag of bags) {
+        for (const tok of bag.keys()) {
+            df.set(tok, (df.get(tok) ?? 0) + 1);
+        }
+    }
+    const bagIndex = new Map(tools.map((t, i) => [t, bags[i]]));
+    return (tool, words) => {
+        const bag = bagIndex.get(tool);
+        if (!bag)
+            return 0;
+        const totalWeight = [...bag.values()].reduce((s, v) => s + v, 0) || 1;
+        let score = 0;
+        for (const word of words) {
+            const tf = (bag.get(word) ?? 0) / totalWeight;
+            const docFreq = df.get(word) ?? 0;
+            if (docFreq === 0)
+                continue;
+            const idf = Math.log((N + 1) / docFreq);
+            score += tf * idf;
+        }
+        return score;
+    };
+}
+// ---------------------------------------------------------------------------
+// searchTools
+// ---------------------------------------------------------------------------
+/**
+ * Search tools by keyword using TF-IDF relevance ranking.
+ *
+ * Matching: ALL query words must appear in at least one of name, tags, or
+ * description (case-insensitive substring match used for filtering; TF-IDF
+ * token scoring used for ranking).
+ *
+ * Returns up to `limit` results in descending relevance order.
+ */
+export function searchTools(tools, query, provider, limit) {
+    const words = tokenize(query);
+    if (words.length === 0)
+        return [];
+    const source = provider ? tools.filter((t) => t.providerName === provider) : tools;
+    const scoreFn = buildTfIdf(source);
+    const candidates = [];
+    for (const tool of source) {
+        const nameLower = tool.mcpName.toLowerCase();
+        const tagsText = tool.tags.join(" ").toLowerCase();
+        const descLower = tool.description.toLowerCase();
+        const allMatch = words.every((word) => nameLower.includes(word) || tagsText.includes(word) || descLower.includes(word));
+        if (allMatch) {
+            candidates.push({ tool, score: scoreFn(tool, words) });
+        }
+    }
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates.slice(0, limit).map(({ tool }) => ({
+        name: tool.mcpName,
+        description: tool.description,
+        tags: tool.tags,
+    }));
+}
+// ---------------------------------------------------------------------------
+// groupTools
+// ---------------------------------------------------------------------------
+/**
+ * Group tools by provider name or by OpenAPI tag.
+ * Tools with no tags fall back to grouping under their provider name.
+ */
+export function groupTools(tools, by) {
+    const grouped = {};
+    for (const tool of tools) {
+        if (by === "provider") {
+            (grouped[tool.providerName] ??= []).push(tool.mcpName);
+        }
+        else {
+            const keys = tool.tags.length > 0 ? tool.tags : [tool.providerName];
+            for (const key of keys) {
+                (grouped[key] ??= []).push(tool.mcpName);
+            }
+        }
+    }
+    return grouped;
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/server.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+/**
+ * @utdk/mcp-server — Unified MCP server with dynamic tool loading.
+ *
+ * Usage:
+ *   UTDK_PROVIDERS=github,slack npx @utdk/mcp-server
+ *
+ * MCP config:
+ *   { "command": "npx", "args": ["@utdk/mcp-server"], "env": { "UTDK_PROVIDERS": "github" } }
+ *
+ * Environment variables:
+ *   UTDK_PROVIDERS          Comma-separated list of @utdk providers to load (required)
+ *   UTDK_OTEL_EXPORTER      Telemetry exporter: "otlp" | "console" | unset (noop)
+ *   <PROVIDER>_TOKEN        Bearer token for a provider (e.g. GITHUB_TOKEN)
+ *   <PROVIDER>_SECRET_KEY   API key for a provider (e.g. STRIPE_SECRET_KEY)
+ *
+ * Hot-reload:
+ *   Send SIGHUP to reload provider list from the current UTDK_PROVIDERS env value.
+ */
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { executeTool, initTelemetry, loadProviders, parseProviderNames, } from "./loader.js";
+import { searchTools, groupTools } from "./search.js";
+// ---------------------------------------------------------------------------
+// Schema normalization
+// ---------------------------------------------------------------------------
+/**
+ * Ensure the input schema is a valid MCP tool inputSchema (type: "object").
+ */
+function normalizeInputSchema(schema) {
+    if (schema["type"] === "object") {
+        return {
+            type: "object",
+            ...(schema["properties"]
+                ? { properties: schema["properties"] }
+                : {}),
+            ...(schema["required"] ? { required: schema["required"] } : {}),
+        };
+    }
+    return {
+        type: "object",
+        ...(schema["properties"]
+            ? { properties: schema["properties"] }
+            : {}),
+        ...(schema["required"] ? { required: schema["required"] } : {}),
+    };
+}
+// search_tools and groupTools are imported from ./search.js above.
+// ---------------------------------------------------------------------------
+// MCP Server factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a low-level MCP Server that serves tools from the given ProviderTool list.
+ * Uses raw request handlers for tools/list and tools/call to support dynamic,
+ * JSON-schema-based tool definitions without requiring Zod schemas.
+ */
+function createServer(tools) {
+    const server = new Server({ name: "@utdk/mcp-server", version: "0.1.0" }, { capabilities: { tools: {} } });
+    // Build a lookup map for fast dispatch
+    const toolMap = new Map(tools.map((t) => [t.mcpName, t]));
+    // tools/list — return exactly the 4 meta-tools (no direct provider tool exposure)
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "list_tools",
+                description: "List available tool names without full schemas. Pass an optional provider to filter results, or group_by to organize by category.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        provider: {
+                            type: "string",
+                            description: "Filter results to tools from this provider name (e.g. 'github')",
+                        },
+                        group_by: {
+                            type: "string",
+                            enum: ["provider", "tag"],
+                            description: "Group results by 'provider' or by OpenAPI 'tag'. When omitted, returns a flat list of names.",
+                        },
+                    },
+                },
+            },
+            {
+                name: "search_tools",
+                description: "Find tools by keyword. Searches tool names, OpenAPI tags, and descriptions using TF-IDF relevance ranking so the LLM can locate relevant tools without browsing the full catalog.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Natural language or keyword search (all words must appear in name, tags, or description)",
+                        },
+                        provider: {
+                            type: "string",
+                            description: "Restrict search to tools from this provider name (e.g. 'github')",
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Maximum number of results to return (default 10)",
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "tool_info",
+                description: "Get the full schema and metadata for a specific tool by name. Use this after list_tools or search_tools to retrieve the complete input schema before calling the tool.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        tool_name: {
+                            type: "string",
+                            description: "The MCP tool name (e.g. 'github__repos_list')",
+                        },
+                    },
+                    required: ["tool_name"],
+                },
+            },
+            {
+                name: "call_tool",
+                description: "Execute any registered tool by name with the provided arguments. Use tool_info first to get the correct argument schema.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        tool_name: {
+                            type: "string",
+                            description: "The MCP tool name to execute (e.g. 'github__repos_list')",
+                        },
+                        arguments: {
+                            type: "object",
+                            description: "Arguments to pass to the tool",
+                        },
+                    },
+                    required: ["tool_name", "arguments"],
+                },
+            },
+        ],
+    }));
+    // tools/call — dispatch to the 4 meta-tools only
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const args = (request.params.arguments ?? {});
+        // list_tools meta-tool: enumerate provider tool names without schemas
+        if (toolName === "list_tools") {
+            const providerFilter = typeof args["provider"] === "string" ? args["provider"] : undefined;
+            const groupBy = args["group_by"] === "provider" || args["group_by"] === "tag"
+                ? args["group_by"]
+                : undefined;
+            const filtered = providerFilter
+                ? tools.filter((t) => t.providerName === providerFilter)
+                : tools;
+            let result;
+            if (groupBy === "provider" || groupBy === "tag") {
+                result = groupTools(filtered, groupBy);
+            }
+            else {
+                result = filtered.map((t) => t.mcpName);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        // search_tools meta-tool: keyword search across tool names and descriptions
+        if (toolName === "search_tools") {
+            const query = typeof args["query"] === "string" ? args["query"] : "";
+            const providerFilter = typeof args["provider"] === "string" ? args["provider"] : undefined;
+            const limit = typeof args["limit"] === "number" && args["limit"] > 0 ? Math.floor(args["limit"]) : 10;
+            const results = searchTools(tools, query, providerFilter, limit);
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        // tool_info meta-tool: return full schema and metadata for a specific tool
+        if (toolName === "tool_info") {
+            const requestedName = typeof args["tool_name"] === "string" ? args["tool_name"] : "";
+            const tool = toolMap.get(requestedName);
+            if (!tool) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${requestedName}` }],
+                };
+            }
+            const info = {
+                name: tool.mcpName,
+                description: tool.description,
+                provider: tool.providerName,
+                inputSchema: normalizeInputSchema(tool.inputSchema),
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+            };
+        }
+        // call_tool meta-tool: execute a registered tool by name
+        if (toolName === "call_tool") {
+            const requestedName = typeof args["tool_name"] === "string" ? args["tool_name"] : "";
+            const toolArgs = typeof args["arguments"] === "object" && args["arguments"] !== null
+                ? args["arguments"]
+                : {};
+            const tool = toolMap.get(requestedName);
+            if (!tool) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${requestedName}` }],
+                };
+            }
+            try {
+                const result = await executeTool(tool, toolArgs);
+                const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+                return { content: [{ type: "text", text }] };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Error calling ${requestedName}: ${message}` }],
+                };
+            }
+        }
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Unknown tool: ${toolName}. Use list_tools or search_tools to discover tools, then call_tool to execute them.`,
+                },
+            ],
+        };
+    });
+    return server;
+}
+// ---------------------------------------------------------------------------
+// Hot-reload support
+// ---------------------------------------------------------------------------
+/**
+ * Reload providers from the current UTDK_PROVIDERS env value.
+ * Returns the new tool list (the caller is responsible for reconnecting if needed).
+ */
+async function reloadProviders() {
+    const providerNames = parseProviderNames(process.env["UTDK_PROVIDERS"]);
+    process.stderr.write(`[mcp-server] (Re)loading providers: ${providerNames.join(", ") || "(none)"}\n`);
+    const tools = await loadProviders(providerNames);
+    process.stderr.write(`[mcp-server] Loaded ${tools.length} total tool(s) from ${providerNames.length} provider(s)\n`);
+    return tools;
+}
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+async function main() {
+    await initTelemetry();
+    const providerNames = parseProviderNames(process.env["UTDK_PROVIDERS"]);
+    if (providerNames.length === 0) {
+        process.stderr.write("[mcp-server] Warning: UTDK_PROVIDERS is not set — starting with no tools.\n" +
+            "[mcp-server] Set UTDK_PROVIDERS=github,slack,stripe to load providers.\n");
+    }
+    else {
+        process.stderr.write(`[mcp-server] Loading providers: ${providerNames.join(", ")}\n`);
+    }
+    let tools = await loadProviders(providerNames);
+    process.stderr.write(`[mcp-server] Ready with ${tools.length} tool(s). Starting MCP stdio server...\n`);
+    let server = createServer(tools);
+    const transport = new StdioServerTransport();
+    // SIGHUP → hot-reload provider list.
+    // Because the MCP protocol is stateful (initialized per connection), we rebuild
+    // the internal request handler registry. The client sees updated tools on the
+    // next tools/list request without needing to reconnect.
+    process.on("SIGHUP", () => {
+        process.stderr.write("[mcp-server] SIGHUP received — reloading providers...\n");
+        reloadProviders()
+            .then((newTools) => {
+            tools = newTools;
+            // Rebuild server handlers in-place by re-registering on the existing server.
+            // The transport connection is preserved; only the handler registry changes.
+            server = createServer(newTools);
+            // Reconnect the new server to the existing transport so future messages
+            // are routed to the updated handler set.
+            server.connect(transport).catch((err) => {
+                process.stderr.write(`[mcp-server] Reconnect error after SIGHUP: ${err}\n`);
+            });
+        })
+            .catch((err) => {
+            process.stderr.write(`[mcp-server] Reload error: ${err}\n`);
+        });
+    });
+    process.on("SIGTERM", () => {
+        process.stderr.write("[mcp-server] SIGTERM received — shutting down.\n");
+        process.exit(0);
+    });
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[mcp-server] Fatal: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map