Method startOne

src/mcp/manager.ts:104–129

Start a single server and register its tools.

(name: string, config: MCPServerConfig)

  /** Start a single server and register its tools. */
  async startOne(name: string, config: MCPServerConfig): Promise<void> {
    // If already running, stop first
    const existing = this.clients.get(name);
    if (existing) await existing.stop();

    // Expand ${ENV_VAR} references in env values, args, headers, and url so a
    // config that stores `${GITHUB_PAT}` (not the literal secret) resolves at
    // launch time from the process environment. Missing vars expand to '' and
    // log a warning so the failure is diagnosable.
    const resolved = expandEnvRefs(config, name);

    const client = new MCPClient(name, resolved);
    this.clients.set(name, client);

    client.on('tools-changed', () => {
      // Re-register tools when the server signals a change
      this.registerTools(client, resolved.destructive ?? true);
    });
    client.on('exit', () => {
      // Server died — keep the registry tools but they'll fail with MCP_UNAVAILABLE
      logger.warn(`MCP ${name} exited unexpectedly`);
    });

    await client.start();
    this.registerTools(client, resolved.destructive ?? true);
  }

  /** (Re-)register all of a client's tools in the QodeX registry. Removes stale entries from previous tool lists. */
  private registerTools(client: MCPClient, destructive: boolean): void {