flutter-inspector-log

{
  "name": "log_get_recent",
  "description": "Retrieve recent logs",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "Maximum count",
        "default": 50
      },
      "level": {
        "type": "string",
        "description": "Filter: log level (debug, info, warning, error)",
        "enum": ["debug", "info", "warning", "error"]
      }
    }
  }
}

{
  "logs": [
    {
      "timestamp": "2024-01-01T10:00:00Z",
      "level": "info",
      "tag": "AuthBloc",
      "message": "User logged in successfully",
      "data": {"userId": 123}
    },
    {
      "timestamp": "2024-01-01T10:00:05Z",
      "level": "error",
      "tag": "NetworkService",
      "message": "Request failed",
      "data": {"url": "/api/users", "statusCode": 500}
    }
  ],
  "totalCount": 2
}

{
  "name": "log_get_errors",
  "description": "Retrieve error logs",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "Maximum count",
        "default": 20
      },
      "includeStackTrace": {
        "type": "boolean",
        "description": "Whether to include stack trace",
        "default": true
      }
    }
  }
}

{
  "errors": [
    {
      "timestamp": "2024-01-01T10:00:05Z",
      "tag": "UserRepository",
      "message": "Failed to fetch user",
      "error": "SocketException: Connection refused",
      "stackTrace": "...",
      "context": {"userId": 123, "attempt": 3}
    }
  ],
  "errorCount": 1
}

{
  "name": "log_search",
  "description": "Search logs",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search string"
      },
      "tag": {
        "type": "string",
        "description": "Filter: tag name"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum count",
        "default": 50
      }
    },
    "required": ["query"]
  }
}

{
  "name": "log_get_stats",
  "description": "Log statistics",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "stats": {
    "totalLogs": 500,
    "byLevel": {
      "debug": 200,
      "info": 250,
      "warning": 30,
      "error": 20
    },
    "topTags": [
      {"tag": "AuthBloc", "count": 50},
      {"tag": "NetworkService", "count": 45},
      {"tag": "HomeBloc", "count": 40}
    ],
    "recentErrors": 5
  },
  "period": "session"
}

{
  "name": "log_clear",
  "description": "Clear logs",
  "inputSchema": {
    "type": "object",
    "properties": {
      "level": {
        "type": "string",
        "description": "Delete only a specific level (omit for all)"
      }
    }
  }
}

// lib/debug/mcp_log_tools.dart
import 'package:mcp_toolkit/mcp_toolkit.dart';
import 'package:logger/logger.dart';

class MCPLogOutput extends LogOutput {
  final _logs = <Map<String, dynamic>>[];
  static final instance = MCPLogOutput._();
  MCPLogOutput._();

  @override
  void output(OutputEvent event) {
    final log = {
      'timestamp': DateTime.now().toIso8601String(),
      'level': event.level.name,
      'lines': event.lines,
    };
    _logs.add(log);

    // Keep maximum 1000 entries
    if (_logs.length > 1000) {
      _logs.removeAt(0);
    }
  }

  List<Map<String, dynamic>> getLogs({int? limit, String? level}) {
    var filtered = _logs.toList();
    if (level != null) {
      filtered = filtered.where((l) => l['level'] == level).toList();
    }
    return filtered.reversed.take(limit ?? 50).toList();
  }

  List<Map<String, dynamic>> getErrors({int? limit}) {
    return _logs
        .where((l) => l['level'] == 'error' || l['level'] == 'wtf')
        .toList()
        .reversed
        .take(limit ?? 20)
        .toList();
  }

  List<Map<String, dynamic>> search(String query, {String? tag, int? limit}) {
    return _logs
        .where((l) => l['lines'].toString().contains(query))
        .where((l) => tag == null || l['tag'] == tag)
        .toList()
        .reversed
        .take(limit ?? 50)
        .toList();
  }

  Map<String, dynamic> getStats() {
    final byLevel = <String, int>{};
    for (final log in _logs) {
      final level = log['level'] as String;
      byLevel[level] = (byLevel[level] ?? 0) + 1;
    }
    return {
      'totalLogs': _logs.length,
      'byLevel': byLevel,
    };
  }

  void clear({String? level}) {
    if (level != null) {
      _logs.removeWhere((l) => l['level'] == level);
    } else {
      _logs.clear();
    }
  }
}

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

  addMcpTool(MCPCallEntry.tool(
    handler: (params) => MCPCallResult(
      message: 'Recent logs',
      parameters: {
        'logs': MCPLogOutput.instance.getLogs(
          limit: params['limit'] as int?,
          level: params['level'] as String?,
        ),
      },
    ),
    definition: MCPToolDefinition(
      name: 'log_get_recent',
      description: 'Retrieve recent logs',
      inputSchema: {
        'type': 'object',
        'properties': {
          'limit': {'type': 'integer'},
          'level': {'type': 'string'},
        },
      },
    ),
  ));

  // log_get_errors, log_search, log_get_stats, log_clear are implemented similarly
}

Q: Show me recent logs
A: Run log_get_recent limit=20
   -> 20 logs (15 info, 3 warning, 2 error)

Q: Show me only error logs
A: Run log_get_errors
   -> 2 errors: SocketException, FormatException

Q: Find authentication related logs
A: Run log_search query="auth"
   -> 15 logs related to AuthBloc, AuthRepository

Q: Summarize the log status
A: Run log_get_stats
   -> Total 500, 20 errors, top tags: AuthBloc, NetworkService

1. Check error patterns with log_get_errors
2. Confirm repeated occurrences from the same tag
3. Analyze error context

1. log_search query="slow" or "timeout"
2. Analyze logs around relevant timeframes
3. Identify bottleneck points

1. Check last error with log_get_errors
2. Analyze stack trace
3. Trace logs immediately before the error