Function loadMCPConfig

sdk/src/agents/load-mcp-config.ts:127–197

(options: {
  verbose?: boolean
})

 * ```
 */
export async function loadMCPConfig(options: {
  verbose?: boolean
}): Promise<LoadedMCPConfig> {
  const { verbose = false } = options

  const mergedConfig: LoadedMCPConfig = {
    mcpServers: {},
    _sourceFilePath: '',
  }

  const mcpConfigDirs = getDefaultMcpConfigDirs()

  for (const dir of mcpConfigDirs) {
    const configPath = path.join(dir, MCP_CONFIG_FILE_NAME)

    try {
      // Check if file exists asynchronously
      try {
        await fsPromises.access(configPath)
      } catch {
        continue
      }

      const content = await fsPromises.readFile(configPath, 'utf8')
      const rawConfig = JSON.parse(content)
      const parseResult = mcpFileSchema.safeParse(rawConfig)

      if (!parseResult.success) {
        if (verbose) {
          console.error(
            `Invalid mcp.json at ${configPath}: ${parseResult.error.message}`,
          )
        }
        continue
      }

      const parsedConfig = parseResult.data

      // Resolve environment variable references
      try {
        resolveMcpConfigEnv(parsedConfig)
      } catch (error) {
        if (verbose) {
          console.error(error instanceof Error ? error.message : String(error))
        }
        continue
      }

      // Merge MCP servers (later directories override earlier ones)
      for (const [serverName, serverConfig] of Object.entries(
        parsedConfig.mcpServers,
      )) {
        mergedConfig.mcpServers[serverName] = serverConfig
      }

      // Track the last successfully loaded config path
      if (Object.keys(parsedConfig.mcpServers).length > 0) {
        mergedConfig._sourceFilePath = configPath