mcp-orbit 0.1.0

package/dist/core/server-http.js

@@ -0,0 +1,302 @@
+/**
+ * HTTP Server Transport (Protocol 2025-03-26)
+ *
+ * Modern MCP server implementation using StreamableHTTPServerTransport
+ * - Session management with transport reuse
+ * - Support for GET/POST/DELETE methods
+ * - Optional resumability with event store
+ * - Bearer token authentication
+ * - Health check endpoint
+ *
+ * Based on MCP SDK official examples
+ */
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import logger from "../utils/logger.js";
+const serverLogger = logger.child("server-http2");
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+const HEALTH_ENDPOINTS = ["/health"];
+const MCP_ENDPOINT = "/mcp";
+// ============================================================================
+// REQUEST CONTEXT & LOGGING
+// ============================================================================
+function createRequestContext(req) {
+    return {
+        requestId: `${Date.now()}-${Math.random().toString(36).substring(7)}`,
+        startTime: Date.now(),
+        clientIp: req.socket.remoteAddress || "unknown",
+        userAgent: req.headers["user-agent"] || "unknown",
+        method: req.method || "UNKNOWN",
+        url: req.url || "/",
+    };
+}
+function logRequest(context, sessionId) {
+    serverLogger.debug("HTTP request", {
+        requestId: context.requestId,
+        method: context.method,
+        url: context.url,
+        sessionId,
+        ip: context.clientIp,
+    });
+}
+function logResponse(statusCode, context, message) {
+    const duration = Date.now() - context.startTime;
+    const logData = {
+        requestId: context.requestId,
+        statusCode,
+        duration: `${duration}ms`,
+        message,
+    };
+    if (statusCode >= 400) {
+        serverLogger.warn("HTTP response (error)", logData);
+    }
+    else {
+        serverLogger.debug("HTTP response (success)", logData);
+    }
+}
+// ============================================================================
+// RESPONSE HELPERS
+// ============================================================================
+function sendJsonResponse(res, statusCode, data, context) {
+    res.statusCode = statusCode;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+    logResponse(statusCode, context, JSON.stringify(data).substring(0, 100));
+}
+function sendJsonRpcError(res, statusCode, code, message, context) {
+    sendJsonResponse(res, statusCode, {
+        jsonrpc: "2.0",
+        error: { code, message },
+        id: null,
+    }, context);
+}
+// ============================================================================
+// AUTHENTICATION
+// ============================================================================
+function checkAuthentication(req) {
+    const apiKey = process.env.MCP_ORBIT_API_KEY;
+    // No API key configured = no auth required (development mode)
+    if (!apiKey) {
+        return { authenticated: true };
+    }
+    const authHeader = req.headers["authorization"];
+    const expectedAuth = `Bearer ${apiKey}`;
+    if (!authHeader) {
+        return {
+            authenticated: false,
+            reason: "No Authorization header provided",
+        };
+    }
+    if (authHeader !== expectedAuth) {
+        return {
+            authenticated: false,
+            reason: "Invalid API key",
+        };
+    }
+    return { authenticated: true };
+}
+// ============================================================================
+// REQUEST HANDLERS
+// ============================================================================
+function isHealthCheckRequest(req) {
+    return req.method === "GET" && HEALTH_ENDPOINTS.includes(req.url);
+}
+function handleHealthCheck(res, context) {
+    sendJsonResponse(res, 200, {
+        status: "ok",
+        service: "mcp-orbit",
+        transport: "streamable-http",
+        protocol: "2025-03-26",
+        timestamp: Date.now(),
+        uptime: process.uptime(),
+    }, context);
+}
+async function handleMCPRequest(req, res, context, mcpServer, transports) {
+    // 1. Check authentication for MCP requests
+    const authResult = checkAuthentication(req);
+    if (!authResult.authenticated) {
+        serverLogger.warn("Unauthorized MCP request", {
+            requestId: context.requestId,
+            ip: context.clientIp,
+            reason: authResult.reason,
+        });
+        sendJsonRpcError(res, 401, -32000, `Unauthorized: ${authResult.reason}`, context);
+        return;
+    }
+    // 2. Read and parse request body
+    const bodyBuffer = await readRequestBody(req);
+    let parsedBody;
+    try {
+        parsedBody = bodyBuffer.length > 0 ? JSON.parse(bodyBuffer.toString("utf8")) : undefined;
+    }
+    catch (parseError) {
+        serverLogger.error("Failed to parse JSON", {
+            requestId: context.requestId,
+            error: parseError instanceof Error ? parseError.message : String(parseError),
+        });
+        sendJsonRpcError(res, 400, -32700, "Parse error: Invalid JSON", context);
+        return;
+    }
+    // 3. Get or create transport (SDK pattern)
+    const sessionId = req.headers["mcp-session-id"];
+    let transport;
+    logRequest(context, sessionId);
+    if (sessionId && transports[sessionId]) {
+        // Reuse existing transport
+        transport = transports[sessionId];
+        serverLogger.debug("Reusing existing transport", {
+            requestId: context.requestId,
+            sessionId,
+        });
+    }
+    else if (!sessionId && req.method === "POST" && isInitializeRequest(parsedBody)) {
+        // Create new transport for initialization request
+        serverLogger.info("Creating new transport (initialize request)", {
+            requestId: context.requestId,
+        });
+        transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            enableJsonResponse: true,
+            onsessioninitialized: (newSessionId) => {
+                serverLogger.info("Session initialized", {
+                    requestId: context.requestId,
+                    sessionId: newSessionId,
+                });
+                transports[newSessionId] = transport;
+            },
+        });
+        // Set up close handler for cleanup
+        transport.onclose = () => {
+            const sid = transport.sessionId;
+            if (sid && transports[sid]) {
+                serverLogger.info("Transport closed, cleaning up session", { sessionId: sid });
+                delete transports[sid];
+            }
+        };
+        // Connect transport to MCP server
+        await mcpServer.connect(transport);
+    }
+    else {
+        // Invalid request - no session ID or not an initialization request
+        serverLogger.warn("Invalid request: no session ID and not an initialize request", {
+            requestId: context.requestId,
+            method: req.method,
+            hasSessionId: !!sessionId,
+            isInitialize: isInitializeRequest(parsedBody),
+        });
+        sendJsonRpcError(res, 400, -32000, "Bad Request: No valid session ID provided or not an initialize request", context);
+        return;
+    }
+    // 4. Handle request with transport
+    try {
+        await transport.handleRequest(req, res, parsedBody);
+        // Log method if available
+        const mcpMethod = parsedBody?.method;
+        logResponse(res.statusCode || 200, context, `mcp:${mcpMethod || "unknown"}`);
+    }
+    catch (error) {
+        serverLogger.error("Transport handleRequest failed", {
+            requestId: context.requestId,
+            sessionId: transport.sessionId,
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        });
+        if (!res.headersSent) {
+            sendJsonRpcError(res, 500, -32603, "Internal server error", context);
+        }
+    }
+}
+function readRequestBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => {
+            chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+        });
+        req.on("error", reject);
+        req.on("end", () => {
+            resolve(Buffer.concat(chunks));
+        });
+    });
+}
+// ============================================================================
+// SERVER STARTUP
+// ============================================================================
+export async function startHttpServer(port, host, mcpServer, logSecurityStatus, logServerStats) {
+    // Transport storage for session management (SDK pattern)
+    const transports = {};
+    // Security warning
+    if (host === "0.0.0.0") {
+        serverLogger.warn("Binding to 0.0.0.0 (all interfaces) - ensure API key is configured!");
+    }
+    // Create HTTP server
+    const httpServer = createServer(async (req, res) => {
+        const context = createRequestContext(req);
+        try {
+            // Route: Health check (no auth required)
+            if (isHealthCheckRequest(req)) {
+                handleHealthCheck(res, context);
+                return;
+            }
+            // Route: MCP endpoint (auth required, all methods supported)
+            if (req.url === MCP_ENDPOINT) {
+                await handleMCPRequest(req, res, context, mcpServer, transports);
+                return;
+            }
+            // Route: Unknown endpoint
+            serverLogger.warn("Unknown endpoint", {
+                requestId: context.requestId,
+                url: req.url,
+            });
+            sendJsonRpcError(res, 404, -32000, `Not Found: Unknown endpoint '${req.url}'`, context);
+        }
+        catch (error) {
+            serverLogger.error("Unhandled request error", {
+                requestId: context.requestId,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            if (!res.headersSent) {
+                sendJsonRpcError(res, 500, -32603, "Internal server error", context);
+            }
+        }
+    });
+    // Start server
+    await new Promise((resolve, reject) => {
+        httpServer.listen(port, host, () => resolve());
+        httpServer.on("error", reject);
+    });
+    // Graceful shutdown
+    const cleanup = async () => {
+        serverLogger.info("Shutting down server...");
+        // Close all active transports
+        const sessionIds = Object.keys(transports);
+        if (sessionIds.length > 0) {
+            serverLogger.info(`Closing ${sessionIds.length} active sessions`);
+            await Promise.all(sessionIds.map(async (sessionId) => {
+                try {
+                    await transports[sessionId].close();
+                    delete transports[sessionId];
+                }
+                catch (error) {
+                    serverLogger.error(`Error closing transport for session ${sessionId}`, {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }));
+        }
+        httpServer.close(() => process.exit(0));
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    // Log startup info
+    serverLogger.info("MCP Server ready (Streamable HTTP Transport - Protocol 2025-03-26)");
+    serverLogger.info(`   URL: http://${host}:${port}${MCP_ENDPOINT}`);
+    serverLogger.info(`   Health: http://${host}:${port}/health`);
+    logSecurityStatus();
+    logServerStats();
+}
+//# sourceMappingURL=server-http.js.map

package/dist/core/server-http.js.map

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

package/dist/core/server-stdio.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stdio Server Transport
+ *
+ * Handles stdio transport for MCP server (Claude Desktop, CLI clients)
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function startStdioServer(mcpServer: Server, logServerStats: () => void): Promise<void>;
+//# sourceMappingURL=server-stdio.d.ts.map

package/dist/core/server-stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-stdio.d.ts","sourceRoot":"","sources":["../../src/core/server-stdio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,2CAA2C,CAAC;AAKtE,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnG"}

package/dist/core/server-stdio.js

@@ -0,0 +1,15 @@
+/**
+ * Stdio Server Transport
+ *
+ * Handles stdio transport for MCP server (Claude Desktop, CLI clients)
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import logger from "../utils/logger.js";
+const serverLogger = logger.child("server");
+export async function startStdioServer(mcpServer, logServerStats) {
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    serverLogger.info("MCP Server ready (stdio transport)");
+    logServerStats();
+}
+//# sourceMappingURL=server-stdio.js.map

package/dist/core/server-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-stdio.js","sourceRoot":"","sources":["../../src/core/server-stdio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAC;AAE/E,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,cAA0B;IAClF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnC,YAAY,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC;AACnB,CAAC"}

package/dist/core/server.d.ts

@@ -0,0 +1,29 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Tool, MCPToolResult, MCPToolDefinition, MCPPlugin } from "./types.js";
+export type TransportMode = "stdio" | "http";
+export interface ServerConfig {
+    mode: TransportMode;
+    httpPort?: number;
+    httpHost?: string;
+    tools?: Tool[];
+    plugins?: MCPPlugin[];
+    serverName?: string;
+    serverVersion?: string;
+}
+export declare function registerTool(tool: Tool): void;
+/**
+ * Register an entire plugin (tools + resources + prompts) in one call.
+ *
+ * ```typescript
+ * import { krakenPlugin } from "mcp-plugin-kraken";
+ * await registerPlugin(krakenPlugin);
+ * ```
+ */
+export declare function registerPlugin(plugin: MCPPlugin): Promise<void>;
+export declare function getTool(name: string): Tool | undefined;
+export declare function getToolDefinitions(): MCPToolDefinition[];
+export declare function getToolCount(): number;
+export declare function executeTool(name: string, args: unknown): Promise<MCPToolResult>;
+export declare function createMCPServer(name?: string, version?: string): Server;
+export declare function startServer(config: ServerConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/core/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,2CAA2C,CAAC;AAiBjE,OAAO,KAAK,EAAC,IAAI,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAC,MAAM,YAAY,CAAC;AAUlF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAC7C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAK7C;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtD;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CASxD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AA+DD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA8BrF;AAED,wBAAgB,eAAe,CAAC,IAAI,SAAc,EAAE,OAAO,SAAU,GAAG,MAAM,CA+E7E;AA4BD,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBrE"}

package/dist/core/server.js

@@ -0,0 +1,265 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { inspect } from "node:util";
+import { resourceRegistry } from "./resource-registry.js";
+import { promptRegistry } from "./prompt-registry.js";
+import { startHttpServer } from "./server-http.js";
+import { startStdioServer } from "./server-stdio.js";
+import logger from "../utils/logger.js";
+import { isZodArray } from "../utils/zod-to-mcp-schema.js";
+import { createAndRegisterResource } from "./resource-registry.js";
+import { createAndRegisterPrompt } from "./prompt-registry.js";
+const serverLogger = logger.child("server");
+const toolLogger = logger.child("tools");
+const DEFAULT_HTTP_PORT = 3333;
+const DEFAULT_HTTP_HOST = "0.0.0.0";
+const MAX_PREVIEW = 160;
+const toolRegistry = new Map();
+export function registerTool(tool) {
+    if (toolRegistry.has(tool.definition.name)) {
+        toolLogger.warn(`Tool '${tool.definition.name}' already registered, overwriting.`);
+    }
+    toolRegistry.set(tool.definition.name, tool);
+}
+/**
+ * Register an entire plugin (tools + resources + prompts) in one call.
+ *
+ * ```typescript
+ * import { krakenPlugin } from "mcp-plugin-kraken";
+ * await registerPlugin(krakenPlugin);
+ * ```
+ */
+export async function registerPlugin(plugin) {
+    const pluginLogger = serverLogger.child(plugin.name);
+    if (plugin.init) {
+        pluginLogger.info("Initializing plugin...");
+        await plugin.init();
+    }
+    const toolCount = plugin.tools?.length ?? 0;
+    const resourceCount = plugin.resources?.length ?? 0;
+    const promptCount = plugin.prompts?.length ?? 0;
+    plugin.tools?.forEach((tool) => registerTool(tool));
+    plugin.resources?.forEach((resource) => createAndRegisterResource(resource));
+    plugin.prompts?.forEach((prompt) => createAndRegisterPrompt(prompt));
+    pluginLogger.info(`Plugin registered: ${toolCount} tools, ${resourceCount} resources, ${promptCount} prompts`);
+}
+export function getTool(name) {
+    return toolRegistry.get(name);
+}
+export function getToolDefinitions() {
+    return Array.from(toolRegistry.values()).map((tool) => {
+        const def = tool.definition;
+        // Inject tags into _meta so they survive MCP SDK's Zod stripping
+        if (def.tags && def.tags.length > 0) {
+            return { ...def, _meta: { ...def._meta, tags: def.tags } };
+        }
+        return def;
+    });
+}
+export function getToolCount() {
+    return toolRegistry.size;
+}
+// Helpers
+const getErrorMsg = (err) => (err instanceof Error ? `${err.name}: ${err.message}` : String(err));
+const truncate = (text, maxLen) => (text.length <= maxLen ? text : `${text.slice(0, maxLen - 3)}...`);
+const formatArgsPreview = (args) => {
+    try {
+        const sanitized = JSON.parse(JSON.stringify(args));
+        const preview = inspect(sanitized, {
+            depth: 2,
+            breakLength: 80,
+            maxArrayLength: 10,
+            maxStringLength: 120,
+            colors: false,
+        });
+        return truncate(preview, MAX_PREVIEW).replace(/\s+/g, " ").trim();
+    }
+    catch {
+        return "[unprintable arguments]";
+    }
+};
+const formatResultSummary = (result) => {
+    const parts = [result.isError ? "error" : "ok"];
+    if (Array.isArray(result.content) && result.content.length > 0) {
+        const firstContent = result.content[0];
+        if (firstContent?.type === "text" && typeof firstContent.text === "string") {
+            parts.push(`text="${truncate(firstContent.text.trim(), MAX_PREVIEW)}"`);
+        }
+        else {
+            const types = [...new Set(result.content.map((c) => c.type))];
+            parts.push(`contentTypes=[${types.join(",")}]`);
+        }
+    }
+    else {
+        parts.push("content=none");
+    }
+    const structured = result.structuredContent;
+    if (structured !== undefined) {
+        if (Array.isArray(structured)) {
+            parts.push(`structured=array(len=${structured.length})`);
+        }
+        else if (structured && typeof structured === "object") {
+            const keys = Object.keys(structured).slice(0, 4);
+            const hasMore = Object.keys(structured).length > keys.length ? "..." : "";
+            parts.push(`structuredKeys=[${keys.join(",")}${hasMore}]`);
+        }
+        else {
+            parts.push(`structured=${typeof structured}`);
+        }
+    }
+    return parts.join(" | ");
+};
+const getRuntimeInputSchema = (tool) => {
+    if (!tool.runtimeInputSchema) {
+        throw new Error(`Tool '${tool.definition.name}' has no runtimeInputSchema configured`);
+    }
+    return tool.runtimeInputSchema;
+};
+const getRuntimeOutputSchema = (tool) => tool.runtimeOutputSchema;
+export async function executeTool(name, args) {
+    const tool = getTool(name);
+    if (!tool)
+        throw new Error(`Unknown tool: ${name}`);
+    const logPrefix = `[tool] ${name}`;
+    const start = Date.now();
+    toolLogger.info(`🔧 TOOL CALL: ${name} | args=${formatArgsPreview(args)}`);
+    let validatedArgs;
+    try {
+        validatedArgs = getRuntimeInputSchema(tool).parse(args);
+    }
+    catch (error) {
+        const duration = Date.now() - start;
+        toolLogger.error(`${logPrefix} validation failed (${duration}ms): ${getErrorMsg(error)}`);
+        throw error;
+    }
+    let result;
+    try {
+        result = await tool.execute(validatedArgs);
+    }
+    catch (error) {
+        const duration = Date.now() - start;
+        toolLogger.error(`${logPrefix} execution failed (${duration}ms): ${getErrorMsg(error)}`);
+        throw error;
+    }
+    const duration = Date.now() - start;
+    toolLogger.info(`✅ TOOL COMPLETED: ${name} | ${duration}ms | status=${result.isError ? "ERROR" : "OK"}`);
+    return result;
+}
+export function createMCPServer(name = "mcp-orbit", version = "1.0.0") {
+    const server = new Server({
+        name,
+        version,
+    }, {
+        capabilities: {
+            tools: {},
+            resources: { listChanged: true },
+            prompts: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        try {
+            const definitions = getToolDefinitions();
+            return {
+                tools: definitions,
+            };
+        }
+        catch (error) {
+            serverLogger.error("Error getting tool definitions:", getErrorMsg(error));
+            throw error; // Re-throw to ensure the client receives an error response
+        }
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            const result = await executeTool(name, args);
+            const tool = getTool(name);
+            const runtimeOutputSchema = tool ? getRuntimeOutputSchema(tool) : undefined;
+            // Automatically wrap array outputs to match the schema transformation
+            if (runtimeOutputSchema && isZodArray(runtimeOutputSchema) && result.structuredContent) {
+                result.structuredContent = { result: result.structuredContent };
+            }
+            return {
+                content: result.content,
+                structuredContent: result.structuredContent,
+                _meta: result._meta,
+                isError: result.isError,
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Tool execution failed: ${getErrorMsg(error)}` }],
+            };
+        }
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: resourceRegistry.listDefinitions(),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        try {
+            return await resourceRegistry.read(request.params.uri);
+        }
+        catch (error) {
+            throw new Error(`Failed to read resource: ${getErrorMsg(error)}`);
+        }
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: promptRegistry.listDefinitions(),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            return await promptRegistry.get(name, args);
+        }
+        catch (error) {
+            throw new Error(`Failed to get prompt: ${getErrorMsg(error)}`);
+        }
+    });
+    return server;
+}
+function logSecurityStatus() {
+    const status = process.env.MCP_ORBIT_API_KEY
+        ? "   Auth: ✓ API Key authentication enabled"
+        : "   Auth: ✗ No MCP_ORBIT_API_KEY set — server accepts all requests (development mode).";
+    const logger = process.env.MCP_ORBIT_API_KEY ? serverLogger.info : serverLogger.warn;
+    logger(status);
+}
+function logServerStats() {
+    const toolNames = getToolDefinitions()
+        .map((t) => t.name)
+        .join(", ");
+    const resourceUris = resourceRegistry
+        .listDefinitions()
+        .map((r) => r.uri)
+        .join(", ");
+    const promptNames = promptRegistry
+        .listDefinitions()
+        .map((p) => p.name)
+        .join(", ");
+    serverLogger.info(`   Tools:     ${getToolCount()} (${toolNames})`);
+    serverLogger.info(`   Resources: ${resourceRegistry.count} (${resourceUris})`);
+    serverLogger.info(`   Prompts:   ${promptRegistry.count} (${promptNames})`);
+}
+export async function startServer(config) {
+    // Auto-redirect logs to stderr in stdio mode (prevents JSON-RPC stream corruption)
+    if (config.mode === "stdio") {
+        const { _setForceStdErrMode } = await import("../utils/logger.js");
+        _setForceStdErrMode(true);
+    }
+    config.tools?.forEach((tool) => registerTool(tool));
+    // Register plugins (tools + resources + prompts in one call)
+    if (config.plugins) {
+        for (const plugin of config.plugins) {
+            await registerPlugin(plugin);
+        }
+    }
+    const mcpServer = createMCPServer(config.serverName, config.serverVersion);
+    const { mode, httpPort = DEFAULT_HTTP_PORT, httpHost = DEFAULT_HTTP_HOST } = config;
+    if (mode === "http") {
+        await startHttpServer(httpPort, httpHost, mcpServer, logSecurityStatus, logServerStats);
+    }
+    else {
+        await startStdioServer(mcpServer, logServerStats);
+    }
+}
+//# sourceMappingURL=server.js.map