get_configuration

Instructions

Implementation Reference

• src/index.ts:253-266 (handler)

  Main handler for 'get_configuration' tool: validates client input, computes config path, reads and parses config file, returns pretty-printed JSON.

  case 'get_configuration': {
    const client = validateClient(args.client);
    const configPath = getConfigPath(client);
    const config = await readConfigFile(configPath);
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(config, null, 2),
        },
      ],
    };
  }

• src/index.ts:141-154 (registration)

  Tool registration in ListToolsRequestSchema response, defining name, description, and input schema.

  {
    name: 'get_configuration',
    description: 'Get the entire configuration for a specific client',
    inputSchema: {
      type: 'object',
      properties: {
        client: {
          type: 'string',
          description: 'Client name (cline, roo_code, windsurf, claude)',
        },
      },
      required: ['client'],
    },
  },

• src/index.ts:70-81 (helper)

  Helper function that reads the configuration file at the given path and parses it as JSON, throwing MCP errors on failure. Used directly in the handler.

  const readConfigFile = async (configPath: string): Promise<any> => {
    try {
      const data = await fs.readFile(configPath, 'utf8');
      return JSON.parse(data);
    } catch (error: unknown) {
      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
        throw new McpError(ErrorCode.InternalError, `Configuration file not found: ${configPath}`);
      }
      const errorMessage = error instanceof Error ? error.message : String(error);
      throw new McpError(ErrorCode.InternalError, `Error reading configuration file: ${errorMessage}`);
    }
  };

• src/index.ts:18-52 (helper)

  Helper function to determine the exact file path for a client's MCP configuration based on OS platform and client type. Called by the handler.

  const getConfigPath = (client: ClientType): string => {
    const platform = os.platform();
    const homeDir = os.homedir();
    
    if (platform === 'win32') {
      // Windows paths
      switch (client) {
        case 'cline':
          return path.join(homeDir, 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
        case 'roo_code':
          return path.join(homeDir, 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'cline_mcp_settings.json');
        case 'windsurf':
          return path.join(homeDir, 'AppData', 'Roaming', 'WindSurf', 'mcp_settings.json');
        case 'claude':
          return path.join(homeDir, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
        default:
          throw new McpError(ErrorCode.InvalidParams, `Unsupported client: ${client}`);
      }
    } else if (platform === 'darwin') {
      // macOS paths
      switch (client) {
        case 'cline':
          return path.join(homeDir, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
        case 'roo_code':
          return path.join(homeDir, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'cline_mcp_settings.json');
        case 'windsurf':
          return path.join(homeDir, '.codeium', 'windsurf', 'mcp_config.json');
        case 'claude':
          return path.join(homeDir, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
        default:
          throw new McpError(ErrorCode.InvalidParams, `Unsupported client: ${client}`);
      }
    } else {
      throw new McpError(ErrorCode.InternalError, `Unsupported platform: ${platform}`);
    }

• src/index.ts:56-67 (helper)

  Helper function to validate and type-check the client parameter. Used at the start of the handler.

  const validateClient = (client: unknown): ClientType => {
    if (typeof client !== 'string') {
      throw new McpError(ErrorCode.InvalidParams, 'Client must be a string');
    }
    
    const validClients: ClientType[] = ['cline', 'roo_code', 'windsurf', 'claude'];
    if (!validClients.includes(client as ClientType)) {
      throw new McpError(ErrorCode.InvalidParams, `Invalid client: ${client}. Must be one of: ${validClients.join(', ')}`);
    }
    
    return client as ClientType;
  };