flutter-inspector-config

Configuration debugging specialist. Use for environment variable and feature flag inspection

항목	내용
모델	`haiku`
사용 도구	`Read`, `Glob`, `Grep`
연계 스킬	`flutter-inspector`

A specialized agent for checking and debugging configuration and feature flags at runtime.

Triggers#

Automatically activated when @flutter-inspector-config is invoked or the following keywords are detected:

Configuration, environment variables
Feature flag, Feature Flag
Environment settings, Configuration

MCP Tools#

config_get_all#

Returns all configuration values.

{
  "name": "config_get_all",
  "description": "Retrieve all configuration",
  "inputSchema": {
    "type": "object",
    "properties": {
      "includeSecrets": {
        "type": "boolean",
        "description": "Whether to include sensitive values (masked)",
        "default": false
      }
    }
  }
}

Response example:

{
  "config": {
    "apiBaseUrl": "https://api.example.com",
    "apiKey": "***masked***",
    "timeout": 30000,
    "retryCount": 3,
    "cacheEnabled": true,
    "logLevel": "debug"
  },
  "source": "environment"
}

config_get_value#

Returns a specific configuration value.

{
  "name": "config_get_value",
  "description": "Retrieve specific configuration",
  "inputSchema": {
    "type": "object",
    "properties": {
      "key": {
        "type": "string",
        "description": "Configuration key"
      }
    },
    "required": ["key"]
  }
}

Response example:

{
  "key": "apiBaseUrl",
  "value": "https://api.example.com",
  "type": "String",
  "source": "environment",
  "overridable": true
}

config_get_feature_flags#

Returns the feature flag status.

{
  "name": "config_get_feature_flags",
  "description": "Retrieve feature flags",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Filter: category (ui, api, experiment)"
      }
    }
  }
}

Response example:

{
  "featureFlags": {
    "ui": {
      "darkModeEnabled": true,
      "newHomeLayout": false,
      "animationsEnabled": true
    },
    "api": {
      "useNewEndpoint": true,
      "enableCaching": true
    },
    "experiment": {
      "abTestVariant": "B",
      "showPromotion": false
    }
  },
  "lastUpdated": "2024-01-01T10:00:00Z"
}

config_get_environment#

Returns the current environment information.

{
  "name": "config_get_environment",
  "description": "Retrieve environment information",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

Response example:

{
  "environment": {
    "name": "development",
    "isDebug": true,
    "isRelease": false,
    "isProfile": false,
    "flavor": "dev",
    "buildNumber": "123",
    "version": "1.0.0"
  },
  "platform": {
    "os": "iOS",
    "osVersion": "17.0",
    "device": "iPhone 15 Pro"
  }
}

App Integration Code#

// lib/debug/mcp_config_tools.dart
import 'package:mcp_toolkit/mcp_toolkit.dart';
import 'package:flutter/foundation.dart';

class ConfigManager {
  static final instance = ConfigManager._();
  ConfigManager._();

  final Map<String, dynamic> _config = {};
  final Map<String, Map<String, bool>> _featureFlags = {};

  void setConfig(String key, dynamic value) => _config[key] = value;
  void setFeatureFlag(String category, String flag, bool value) {
    _featureFlags[category] ??= {};
    _featureFlags[category]![flag] = value;
  }

  Map<String, dynamic> getAll({bool includeSecrets = false}) {
    if (includeSecrets) return Map.from(_config);

    return _config.map((key, value) {
      if (_isSensitive(key)) {
        return MapEntry(key, '***masked***');
      }
      return MapEntry(key, value);
    });
  }

  bool _isSensitive(String key) {
    final sensitiveKeys = ['apiKey', 'secret', 'password', 'token'];
    return sensitiveKeys.any((k) => key.toLowerCase().contains(k.toLowerCase()));
  }

  dynamic getValue(String key) => _config[key];
  Map<String, Map<String, bool>> getFeatureFlags() => _featureFlags;
}

void registerConfigTools() {
  if (!kDebugMode) return;

  addMcpTool(MCPCallEntry.tool(
    handler: (params) {
      final includeSecrets = params['includeSecrets'] as bool? ?? false;
      return MCPCallResult(
        message: 'All config',
        parameters: {
          'config': ConfigManager.instance.getAll(includeSecrets: includeSecrets),
        },
      );
    },
    definition: MCPToolDefinition(
      name: 'config_get_all',
      description: 'Retrieve all configuration',
      inputSchema: {
        'type': 'object',
        'properties': {
          'includeSecrets': {'type': 'boolean', 'default': false},
        },
      },
    ),
  ));

  addMcpTool(MCPCallEntry.tool(
    handler: (params) {
      final key = params['key'] as String;
      return MCPCallResult(
        message: 'Config value',
        parameters: {
          'key': key,
          'value': ConfigManager.instance.getValue(key),
        },
      );
    },
    definition: MCPToolDefinition(
      name: 'config_get_value',
      description: 'Retrieve specific configuration',
      inputSchema: {
        'type': 'object',
        'properties': {
          'key': {'type': 'string'},
        },
        'required': ['key'],
      },
    ),
  ));

  addMcpTool(MCPCallEntry.tool(
    handler: (_) {
      return MCPCallResult(
        message: 'Feature flags',
        parameters: {
          'featureFlags': ConfigManager.instance.getFeatureFlags(),
        },
      );
    },
    definition: MCPToolDefinition(
      name: 'config_get_feature_flags',
      description: 'Retrieve feature flags',
      inputSchema: {'type': 'object', 'properties': {}},
    ),
  ));

  addMcpTool(MCPCallEntry.tool(
    handler: (_) {
      return MCPCallResult(
        message: 'Environment info',
        parameters: {
          'environment': {
            'name': const String.fromEnvironment('FLAVOR', defaultValue: 'development'),
            'isDebug': kDebugMode,
            'isRelease': kReleaseMode,
            'isProfile': kProfileMode,
          },
        },
      );
    },
    definition: MCPToolDefinition(
      name: 'config_get_environment',
      description: 'Retrieve environment information',
      inputSchema: {'type': 'object', 'properties': {}},
    ),
  ));
}

Usage Examples#

Check all configuration#

Q: Show me the current app configuration
A: Run config_get_all
   -> apiBaseUrl, timeout, cacheEnabled, etc. displayed

Check specific configuration#

Q: What is the API timeout setting?
A: Run config_get_value key="timeout"
   -> timeout: 30000ms

Check feature flags#

Q: What feature flags are enabled?
A: Run config_get_feature_flags
   -> darkModeEnabled: true, newHomeLayout: false

Check environment info#

Q: What environment is the app running in?
A: Run config_get_environment
   -> development, debug mode, iOS 17.0

Common Problem Diagnosis#

Feature not working#

1. Check flag status with config_get_feature_flags
2. Check the relevant feature flag value
3. Review flag condition logic

Environment configuration mismatch#

1. Check current environment with config_get_environment
2. Check configuration values with config_get_all
3. Compare with expected environment

API connection issues#

1. Check config_get_value key="apiBaseUrl"
2. Verify it is the correct endpoint
3. Check configuration differences across environments

Caching issues#

1. Check config_get_value key="cacheEnabled"
2. Review cache-related settings
3. Verify cache is disabled in development environment

Envied Integration#

// shared/config/lib/src/env/env.dart
@Envied(path: '.env')
abstract class Env {
  @EnviedField(varName: 'API_BASE_URL')
  static const String apiBaseUrl = _Env.apiBaseUrl;

  @EnviedField(varName: 'API_KEY', obfuscate: true)
  static const String apiKey = _Env.apiKey;
}

// Register with ConfigManager during initialization
void initializeConfig() {
  ConfigManager.instance
    ..setConfig('apiBaseUrl', Env.apiBaseUrl)
    ..setConfig('apiKey', Env.apiKey)
    ..setFeatureFlag('ui', 'darkModeEnabled', true);
}

@flutter-inspector: Master inspector
@flutter-inspector-network: API configuration related
@flutter-inspector-auth: Authentication configuration related

flutter-inspector-config

Triggers#

MCP Tools#

config_get_all#

config_get_value#

config_get_feature_flags#

config_get_environment#

App Integration Code#

Usage Examples#

Check all configuration#

Check specific configuration#

Check feature flags#

Check environment info#

Common Problem Diagnosis#

Feature not working#

Environment configuration mismatch#

API connection issues#

Caching issues#

Envied Integration#

Related Agents#