Method startSingleServer

src/node/services/mcpServerManager.ts:1525–1631

(
    name: string,
    info: MCPServerInfo,
    runtime: Runtime,
    projectPath: string,
    workspacePath: string,
    projectSecrets: Record<string, string> | undefined,
    onActivity: () => void
  )

  }

  private async startSingleServer(
    name: string,
    info: MCPServerInfo,
    runtime: Runtime,
    projectPath: string,
    workspacePath: string,
    projectSecrets: Record<string, string> | undefined,
    onActivity: () => void
  ): Promise<MCPServerInstance | null> {
    let timeoutHandle: ReturnType<typeof setTimeout> | undefined;
    const abortController = new AbortController();
    let abortCleanupPromise: Promise<void> | null = null;

    const registerAbortCleanup = (cleanupPromise: Promise<void>) => {
      abortCleanupPromise ??= cleanupPromise;
    };

    let didTimeout = false;
    const keepPendingAfterTimeout = () => new Promise<MCPServerInstance | null>(() => undefined);

    const startup = this.startSingleServerImpl(
      name,
      info,
      runtime,
      projectPath,
      workspacePath,
      projectSecrets,
      onActivity,
      abortController.signal,
      registerAbortCleanup
    ).then(
      (instance) => (didTimeout ? keepPendingAfterTimeout() : instance),
      (error) => {
        if (didTimeout) {
          return keepPendingAfterTimeout();
        }
        throw error;
      }
    );

    const timeout = new Promise<never>((_resolve, reject) => {
      timeoutHandle = setTimeout(() => {
        didTimeout = true;

        // Promise.race does not cancel the losing startup branch automatically.
        // Abort in-flight startup so stdio processes and partial MCP clients are cleaned up.
        abortController.abort();

        const timeoutError = new MCPStartupTimeoutError(name, MCP_STARTUP_TIMEOUT_MS);
        if (!abortCleanupPromise) {
          reject(timeoutError);
          return;
        }

        const cleanupWait = abortCleanupPromise.catch((error: unknown) => {
          log.debug("[MCP] Error waiting for startup cleanup", {
            name,
            error: getErrorMessage(error),