Function startMcpServer

src/server/start-mcp-server.ts:40–222

()

 * sets up signal handlers for graceful shutdown, and starts the server.
 */
export async function startMcpServer(): Promise<void> {
  let idleShutdown: McpIdleShutdownController | null = null;

  const lifecycle = createMcpLifecycleCoordinator({
    onShutdown: async ({ reason, error, snapshot, server }) => {
      idleShutdown?.stop();

      const isCrash = reason === 'uncaught-exception' || reason === 'unhandled-rejection';
      const event = isCrash ? 'crash' : 'shutdown';

      const transportMessages: Record<string, string> = {
        'stdin-end': 'MCP stdin ended; shutting down MCP server',
        'stdin-close': 'MCP stdin closed; shutting down MCP server',
        'stdout-error': 'MCP stdout pipe broke; shutting down MCP server',
        'stderr-error': 'MCP stderr pipe broke; shutting down MCP server',
        'idle-timeout': 'MCP idle timeout reached; shutting down MCP server',
      };
      log('info', transportMessages[reason] ?? `MCP shutdown requested: ${reason}`);

      if (!isTransportDisconnectReason(reason)) {
        recordMcpLifecycleMetric({
          event,
          phase: snapshot.phase,
          reason,
          uptimeMs: snapshot.uptimeMs,
          rssBytes: snapshot.rssBytes,
          matchingMcpProcessCount: snapshot.matchingMcpProcessCount,
          activeOperationCount: snapshot.activeOperationCount,
          watcherRunning: snapshot.watcherRunning,
        });

        for (const anomaly of snapshot.anomalies) {
          recordMcpLifecycleAnomalyMetric({
            kind: anomaly,
            phase: snapshot.phase,
            reason,
          });
        }
      }

      const result = await runMcpShutdown({
        reason,
        error,
        snapshot,
        server,
      });

      lifecycle.detachProcessHandlers();
      process.exit(result.exitCode);
    },
  });

  lifecycle.attachProcessHandlers();

  try {
    const profiler = createStartupProfiler('start-mcp-server');

    // MCP mode defaults to info level logging