npm - @mcp-shark/mcp-shark - Versions diffs - 1.5.3 → 1.5.5 - Mend

@mcp-shark/mcp-shark 1.5.3 → 1.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (188) hide show

package/README.md +32 -96
package/bin/mcp-shark.js +1 -1
package/core/configs/codex.js +68 -0
package/core/configs/environment.js +51 -0
package/{lib/common → core}/configs/index.js +16 -1
package/core/constants/Defaults.js +15 -0
package/core/constants/HttpStatus.js +14 -0
package/core/constants/Server.js +20 -0
package/core/constants/StatusCodes.js +25 -0
package/core/constants/index.js +7 -0
package/core/container/DependencyContainer.js +179 -0
package/core/db/init.js +33 -0
package/core/index.js +10 -0
package/{mcp-server/lib/common/error.js → core/libraries/ErrorLibrary.js} +4 -0
package/core/libraries/LoggerLibrary.js +91 -0
package/core/libraries/SerializationLibrary.js +32 -0
package/core/libraries/bootstrap-logger.js +19 -0
package/core/libraries/errors/ApplicationError.js +97 -0
package/core/libraries/index.js +17 -0
package/{mcp-server/lib → core/mcp-server}/auditor/audit.js +77 -53
package/core/mcp-server/index.js +192 -0
package/{mcp-server/lib → core/mcp-server}/server/external/all.js +1 -1
package/core/mcp-server/server/external/config.js +75 -0
package/{mcp-server/lib → core/mcp-server}/server/external/single/client.js +1 -1
package/{mcp-server/lib → core/mcp-server}/server/external/single/request.js +1 -1
package/{mcp-server/lib → core/mcp-server}/server/external/single/run.js +20 -11
package/{mcp-server/lib → core/mcp-server}/server/external/single/transport.js +1 -1
package/{mcp-server/lib → core/mcp-server}/server/internal/handlers/error.js +1 -1
package/core/mcp-server/server/internal/handlers/prompts-get.js +28 -0
package/core/mcp-server/server/internal/handlers/prompts-list.js +21 -0
package/core/mcp-server/server/internal/handlers/resources-list.js +21 -0
package/core/mcp-server/server/internal/handlers/resources-read.js +28 -0
package/core/mcp-server/server/internal/handlers/tools-call.js +44 -0
package/core/mcp-server/server/internal/handlers/tools-list.js +23 -0
package/core/mcp-server/server/internal/run.js +53 -0
package/{mcp-server/lib → core/mcp-server}/server/internal/server.js +11 -1
package/core/models/ConversationFilters.js +31 -0
package/core/models/ExportFormat.js +8 -0
package/core/models/RequestFilters.js +43 -0
package/core/models/SessionFilters.js +23 -0
package/core/models/index.js +8 -0
package/core/repositories/AuditRepository.js +233 -0
package/core/repositories/ConversationRepository.js +182 -0
package/core/repositories/PacketRepository.js +237 -0
package/core/repositories/SchemaRepository.js +107 -0
package/core/repositories/SessionRepository.js +59 -0
package/core/repositories/StatisticsRepository.js +54 -0
package/core/repositories/index.js +10 -0
package/core/services/AuditService.js +144 -0
package/core/services/BackupService.js +222 -0
package/core/services/ConfigDetectionService.js +89 -0
package/core/services/ConfigFileService.js +210 -0
package/core/services/ConfigPatchingService.js +137 -0
package/core/services/ConfigService.js +250 -0
package/core/services/ConfigTransformService.js +178 -0
package/core/services/ConversationService.js +19 -0
package/core/services/ExportService.js +117 -0
package/core/services/LogService.js +64 -0
package/core/services/McpClientService.js +235 -0
package/core/services/McpDiscoveryService.js +107 -0
package/core/services/RequestService.js +56 -0
package/core/services/ScanCacheService.js +242 -0
package/core/services/ScanService.js +167 -0
package/core/services/ServerManagementService.js +206 -0
package/core/services/SessionService.js +34 -0
package/core/services/SettingsService.js +163 -0
package/core/services/StatisticsService.js +64 -0
package/core/services/TokenService.js +94 -0
package/core/services/index.js +25 -0
package/core/services/parsers/ConfigParserFactory.js +113 -0
package/core/services/parsers/JsonConfigParser.js +66 -0
package/core/services/parsers/LegacyJsonConfigParser.js +71 -0
package/core/services/parsers/TomlConfigParser.js +87 -0
package/core/services/parsers/index.js +4 -0
package/{ui/server → core}/utils/scan-cache/directory.js +1 -1
package/core/utils/validation.js +77 -0
package/package.json +14 -11
package/ui/dist/assets/index-CArYxKxS.js +35 -0
package/ui/dist/index.html +1 -1
package/ui/server/controllers/BackupController.js +129 -0
package/ui/server/controllers/ConfigController.js +92 -0
package/ui/server/controllers/ConversationController.js +41 -0
package/ui/server/controllers/LogController.js +44 -0
package/ui/server/controllers/McpClientController.js +60 -0
package/ui/server/controllers/McpDiscoveryController.js +44 -0
package/ui/server/controllers/RequestController.js +129 -0
package/ui/server/controllers/ScanController.js +122 -0
package/ui/server/controllers/ServerManagementController.js +134 -0
package/ui/server/controllers/SessionController.js +57 -0
package/ui/server/controllers/SettingsController.js +24 -0
package/ui/server/controllers/StatisticsController.js +54 -0
package/ui/server/controllers/TokenController.js +58 -0
package/ui/server/controllers/index.js +17 -0
package/ui/server/routes/backups/index.js +15 -9
package/ui/server/routes/composite/index.js +62 -32
package/ui/server/routes/composite/servers.js +20 -15
package/ui/server/routes/config.js +13 -172
package/ui/server/routes/conversations.js +9 -19
package/ui/server/routes/help.js +4 -3
package/ui/server/routes/logs.js +14 -26
package/ui/server/routes/playground.js +11 -174
package/ui/server/routes/requests.js +12 -232
package/ui/server/routes/sessions.js +10 -21
package/ui/server/routes/settings.js +10 -192
package/ui/server/routes/smartscan.js +26 -15
package/ui/server/routes/statistics.js +8 -79
package/ui/server/setup.js +162 -0
package/ui/server/swagger/paths/backups.js +151 -0
package/ui/server/swagger/paths/components.js +76 -0
package/ui/server/swagger/paths/config.js +117 -0
package/ui/server/swagger/paths/conversations.js +29 -0
package/ui/server/swagger/paths/help.js +82 -0
package/ui/server/swagger/paths/logs.js +87 -0
package/ui/server/swagger/paths/playground.js +49 -0
package/ui/server/swagger/paths/requests.js +178 -0
package/ui/server/swagger/paths/serverManagement.js +169 -0
package/ui/server/swagger/paths/sessions.js +61 -0
package/ui/server/swagger/paths/settings.js +31 -0
package/ui/server/swagger/paths/smartScan/discovery.js +97 -0
package/ui/server/swagger/paths/smartScan/index.js +13 -0
package/ui/server/swagger/paths/smartScan/scans.js +151 -0
package/ui/server/swagger/paths/smartScan/token.js +71 -0
package/ui/server/swagger/paths/statistics.js +40 -0
package/ui/server/swagger/paths.js +38 -0
package/ui/server/swagger/swagger.js +37 -0
package/ui/server/utils/cleanup.js +99 -0
package/ui/server/utils/config.js +18 -96
package/ui/server/utils/errorHandler.js +43 -0
package/ui/server/utils/logger.js +2 -2
package/ui/server/utils/paths.js +27 -30
package/ui/server/utils/port.js +21 -21
package/ui/server/utils/process.js +18 -10
package/ui/server/utils/processState.js +17 -0
package/ui/server/utils/signals.js +34 -0
package/ui/server/websocket/broadcast.js +33 -0
package/ui/server/websocket/handler.js +52 -0
package/ui/server.js +51 -230
package/ui/src/App.jsx +2 -0
package/ui/src/CompositeSetup.jsx +23 -9
package/ui/src/PacketFilters.jsx +17 -3
package/ui/src/components/AlertModal.jsx +116 -0
package/ui/src/components/App/ApiDocsButton.jsx +57 -0
package/ui/src/components/App/useAppState.js +43 -1
package/ui/src/components/BackupList.jsx +27 -3
package/ui/src/utils/requestPairing.js +35 -36
package/ui/src/utils/requestUtils.js +1 -0
package/lib/common/db/init.js +0 -132
package/lib/common/db/logger.js +0 -349
package/lib/common/db/query.js +0 -403
package/lib/common/logger.js +0 -90
package/mcp-server/index.js +0 -111
package/mcp-server/lib/server/external/config.js +0 -57
package/mcp-server/lib/server/internal/handlers/prompts-get.js +0 -20
package/mcp-server/lib/server/internal/handlers/prompts-list.js +0 -13
package/mcp-server/lib/server/internal/handlers/resources-list.js +0 -13
package/mcp-server/lib/server/internal/handlers/resources-read.js +0 -20
package/mcp-server/lib/server/internal/handlers/tools-call.js +0 -35
package/mcp-server/lib/server/internal/handlers/tools-list.js +0 -15
package/mcp-server/lib/server/internal/run.js +0 -37
package/mcp-server/mcp-shark.js +0 -22
package/ui/dist/assets/index-CFHeMNwd.js +0 -35
package/ui/server/routes/backups/deleteBackup.js +0 -54
package/ui/server/routes/backups/listBackups.js +0 -75
package/ui/server/routes/backups/restoreBackup.js +0 -83
package/ui/server/routes/backups/viewBackup.js +0 -47
package/ui/server/routes/composite/setup.js +0 -129
package/ui/server/routes/composite/status.js +0 -7
package/ui/server/routes/composite/stop.js +0 -39
package/ui/server/routes/composite/utils.js +0 -45
package/ui/server/routes/smartscan/discover.js +0 -118
package/ui/server/routes/smartscan/scans/clearCache.js +0 -23
package/ui/server/routes/smartscan/scans/createBatchScans.js +0 -124
package/ui/server/routes/smartscan/scans/createScan.js +0 -43
package/ui/server/routes/smartscan/scans/getCachedResults.js +0 -52
package/ui/server/routes/smartscan/scans/getScan.js +0 -42
package/ui/server/routes/smartscan/scans/listScans.js +0 -25
package/ui/server/routes/smartscan/scans.js +0 -13
package/ui/server/routes/smartscan/token.js +0 -57
package/ui/server/utils/config-update.js +0 -240
package/ui/server/utils/scan-cache/all-results.js +0 -197
package/ui/server/utils/scan-cache/file-operations.js +0 -107
package/ui/server/utils/scan-cache/hash.js +0 -47
package/ui/server/utils/scan-cache/server-operations.js +0 -85
package/ui/server/utils/scan-cache.js +0 -12
package/ui/server/utils/smartscan-token.js +0 -43
/package/{mcp-server/lib → core/mcp-server}/server/external/kv.js +0 -0
/package/{mcp-server/lib → core/mcp-server}/server/internal/handlers/common.js +0 -0
/package/{mcp-server/lib → core/mcp-server}/server/internal/session.js +0 -0

package/ui/dist/index.html CHANGED Viewed

@@ -7,7 +7,7 @@
     <title>MCP Shark</title>
     <link rel="icon" type="image/png" href="/og-image.png" />
     <link rel="apple-touch-icon" href="/og-image.png" />
-    <script type="module" crossorigin src="/assets/index-CFHeMNwd.js"></script>
+    <script type="module" crossorigin src="/assets/index-CArYxKxS.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-Cc-IUa83.css">
   </head>
   <body>

package/ui/server/controllers/BackupController.js ADDED Viewed

@@ -0,0 +1,129 @@
+import { StatusCodes } from '#core/constants/index.js';
+import { NotFoundError } from '#core/libraries/index.js';
+import { handleError, handleValidationError } from '../utils/errorHandler.js';
+/**
+ * Controller for backup-related HTTP endpoints
+ */
+export class BackupController {
+  constructor(backupService, serverManagementService, logger) {
+    this.backupService = backupService;
+    this.serverManagementService = serverManagementService;
+    this.logger = logger;
+  }
+  /**
+   * Get restore message based on result
+   * @private
+   */
+  _getRestoreMessage(result) {
+    if (result.wasPatched && result.repatched) {
+      return 'Config file restored from backup and automatically repatched (server is running)';
+    }
+    if (result.wasPatched && !result.repatched) {
+      return 'Config file restored from backup (was patched, but server is not running)';
+    }
+    return 'Config file restored from backup';
+  }
+  listBackups = (_req, res) => {
+    try {
+      const backups = this.backupService.listBackups();
+      res.json({ backups });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error listing backups');
+    }
+  };
+  viewBackup = (req, res) => {
+    try {
+      const { backupPath } = req.query;
+      if (!backupPath) {
+        return handleValidationError('backupPath is required', res, this.logger);
+      }
+      const result = this.backupService.viewBackup(backupPath);
+      if (!result) {
+        return handleError(
+          new NotFoundError('Backup file not found', null),
+          res,
+          this.logger,
+          'Error viewing backup'
+        );
+      }
+      res.json({
+        success: true,
+        ...result,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error viewing backup');
+    }
+  };
+  restoreBackup = (req, res) => {
+    try {
+      const { backupPath, originalPath } = req.body;
+      if (!backupPath) {
+        return handleValidationError('backupPath is required', res, this.logger);
+      }
+      // Check if server is running
+      const serverStatus = this.serverManagementService.getServerStatus();
+      const serverIsRunning = serverStatus.running;
+      const result = this.backupService.restoreBackup(backupPath, originalPath, serverIsRunning);
+      if (!result.success) {
+        return res.status(StatusCodes.BAD_REQUEST).json({
+          error: 'ValidationError',
+          message: result.error || 'Failed to restore backup',
+        });
+      }
+      const message = this._getRestoreMessage(result);
+      res.json({
+        success: true,
+        message,
+        originalPath: result.originalPath,
+        wasPatched: result.wasPatched,
+        repatched: result.repatched,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error restoring backup');
+    }
+  };
+  deleteBackup = (req, res) => {
+    try {
+      const { backupPath } = req.body;
+      if (!backupPath) {
+        return handleValidationError('backupPath is required', res, this.logger);
+      }
+      const result = this.backupService.deleteBackup(backupPath);
+      if (!result.success) {
+        return handleError(
+          new NotFoundError(result.error || 'Backup file not found', null),
+          res,
+          this.logger,
+          'Error deleting backup'
+        );
+      }
+      res.json({
+        success: true,
+        message: 'Backup file deleted successfully',
+        backupPath: result.backupPath,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error deleting backup');
+    }
+  };
+}

package/ui/server/controllers/ConfigController.js ADDED Viewed

@@ -0,0 +1,92 @@
+import { StatusCodes } from '#core/constants/index.js';
+/**
+ * Controller for configuration-related HTTP endpoints
+ * Handles HTTP request/response translation for config operations
+ */
+export class ConfigController {
+  constructor(configService, logger) {
+    this.configService = configService;
+    this.logger = logger;
+  }
+  /**
+   * Extract services from config file
+   */
+  extractServices = (req, res) => {
+    try {
+      const { filePath, fileContent } = req.body;
+      if (!filePath && !fileContent) {
+        return res.status(StatusCodes.BAD_REQUEST).json({
+          error: 'Either filePath or fileContent is required',
+        });
+      }
+      const result = this.configService.extractServicesFromFile(filePath, fileContent);
+      if (!result.success) {
+        const statusCode =
+          result.error === 'File not found' ? StatusCodes.NOT_FOUND : StatusCodes.BAD_REQUEST;
+        return res.status(statusCode).json(result);
+      }
+      res.json(result);
+    } catch (error) {
+      this.logger?.error({ error: error.message }, 'Error extracting services');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to extract services',
+        details: error.message,
+      });
+    }
+  };
+  /**
+   * Read config file
+   */
+  readConfig = (req, res) => {
+    try {
+      const { filePath } = req.query;
+      if (!filePath) {
+        return res.status(StatusCodes.BAD_REQUEST).json({ error: 'filePath is required' });
+      }
+      const result = this.configService.readConfigFileWithMetadata(filePath);
+      if (!result.success) {
+        return res.status(StatusCodes.NOT_FOUND).json(result);
+      }
+      res.json(result);
+    } catch (error) {
+      this.logger?.error({ error: error.message }, 'Error reading config');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to read file',
+        details: error.message,
+      });
+    }
+  };
+  /**
+   * Detect config files on the system
+   */
+  detectConfig = (_req, res) => {
+    try {
+      const detected = this.configService.detectConfigFiles();
+      const homeDir = this.configService.getHomeDir();
+      res.json({
+        detected,
+        platform: process.platform,
+        homeDir,
+      });
+    } catch (error) {
+      this.logger?.error({ error: error.message }, 'Error detecting config');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to detect config files',
+        details: error.message,
+      });
+    }
+  };
+}

package/ui/server/controllers/ConversationController.js ADDED Viewed

@@ -0,0 +1,41 @@
+import { StatusCodes } from '#core/constants/StatusCodes.js';
+import { ConversationFilters } from '#core/models/ConversationFilters.js';
+/**
+ * Controller for conversation-related HTTP endpoints
+ */
+export class ConversationController {
+  constructor(conversationService, serializationLib, logger) {
+    this.conversationService = conversationService;
+    this.serializationLib = serializationLib;
+    this.logger = logger;
+  }
+  /**
+   * GET /api/conversations
+   */
+  getConversations(req, res) {
+    try {
+      const filters = new ConversationFilters({
+        sessionId: req.query.sessionId || null,
+        method: req.query.method || null,
+        status: req.query.status || null,
+        jsonrpcId: req.query.jsonrpcId || null,
+        startTime: req.query.startTime || null,
+        endTime: req.query.endTime || null,
+        limit: req.query.limit,
+        offset: req.query.offset,
+      });
+      const conversations = this.conversationService.getConversations(filters);
+      const serialized = this.serializationLib.serializeBigInt(conversations);
+      res.json(serialized);
+    } catch (error) {
+      this.logger.error({ error: error.message }, 'Error in getConversations');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to query conversations',
+        details: error.message,
+      });
+    }
+  }
+}

package/ui/server/controllers/LogController.js ADDED Viewed

@@ -0,0 +1,44 @@
+import { Defaults } from '#core/constants/index.js';
+import { handleError } from '../utils/errorHandler.js';
+/**
+ * Controller for log-related HTTP endpoints
+ */
+export class LogController {
+  constructor(logService, logger) {
+    this.logService = logService;
+    this.logger = logger;
+  }
+  getLogs = (req, res) => {
+    try {
+      const limit = Number.parseInt(req.query.limit) || Defaults.DEFAULT_LIMIT;
+      const offset = Number.parseInt(req.query.offset) || 0;
+      const logs = this.logService.getLogs({ limit, offset });
+      res.json(logs);
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error getting logs');
+    }
+  };
+  clearLogs = (_req, res) => {
+    try {
+      const result = this.logService.clearLogs();
+      res.json(result);
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error clearing logs');
+    }
+  };
+  exportLogs = (_req, res) => {
+    try {
+      const logsText = this.logService.exportLogs();
+      const filename = `mcp-shark-logs-${new Date().toISOString().replace(/[:.]/g, '-')}.txt`;
+      res.setHeader('Content-Type', 'text/plain');
+      res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+      res.send(logsText);
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error exporting logs');
+    }
+  };
+}

package/ui/server/controllers/McpClientController.js ADDED Viewed

@@ -0,0 +1,60 @@
+import { handleError, handleValidationError } from '../utils/errorHandler.js';
+/**
+ * Controller for MCP client (Playground) HTTP endpoints
+ */
+export class McpClientController {
+  constructor(mcpClientService, logger) {
+    this.mcpClientService = mcpClientService;
+    this.logger = logger;
+  }
+  proxyRequest = async (req, res) => {
+    try {
+      const { method, params, serverName } = req.body;
+      if (!method) {
+        return handleValidationError('method field is required', res, this.logger);
+      }
+      if (!serverName) {
+        return handleValidationError('serverName field is required', res, this.logger);
+      }
+      const sessionId =
+        req.headers['mcp-session-id'] ||
+        req.headers['x-mcp-session-id'] ||
+        `playground-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+      const { client } = await this.mcpClientService.getOrCreateClient(serverName, sessionId);
+      this.mcpClientService.updateLastAccessed(serverName, sessionId);
+      const result = await this.mcpClientService.executeMethod(client, method, params);
+      res.setHeader('Mcp-Session-Id', sessionId);
+      res.json({
+        result,
+        _sessionId: sessionId,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error in playground proxy');
+    }
+  };
+  cleanup = async (req, res) => {
+    try {
+      const sessionId = req.headers['mcp-session-id'] || req.headers['x-mcp-session-id'];
+      const { serverName } = req.body || {};
+      if (serverName && sessionId) {
+        await this.mcpClientService.closeClient(serverName, sessionId);
+      } else if (sessionId) {
+        await this.mcpClientService.cleanupSession(sessionId);
+      }
+      res.json({ success: true });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error cleaning up client');
+    }
+  };
+}

package/ui/server/controllers/McpDiscoveryController.js ADDED Viewed

@@ -0,0 +1,44 @@
+import { NotFoundError, ValidationError } from '#core/libraries/index.js';
+import { handleError } from '../utils/errorHandler.js';
+/**
+ * Controller for MCP discovery HTTP endpoints
+ */
+export class McpDiscoveryController {
+  constructor(mcpDiscoveryService, logger) {
+    this.mcpDiscoveryService = mcpDiscoveryService;
+    this.logger = logger;
+  }
+  discoverServers = async (_req, res) => {
+    try {
+      const result = await this.mcpDiscoveryService.discoverAllServers();
+      if (!result.success) {
+        if (result.error === 'MCP config file not found') {
+          return handleError(
+            new NotFoundError('Config file not found', null),
+            res,
+            this.logger,
+            'Error discovering servers'
+          );
+        }
+        if (result.error === 'No servers found in config') {
+          return handleError(
+            new ValidationError('The config file does not contain any MCP servers', null),
+            res,
+            this.logger,
+            'Error discovering servers'
+          );
+        }
+      }
+      return res.json({
+        success: true,
+        servers: result.servers,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error discovering servers');
+    }
+  };
+}

package/ui/server/controllers/RequestController.js ADDED Viewed

@@ -0,0 +1,129 @@
+import { StatusCodes } from '#core/constants/StatusCodes.js';
+import { ExportFormat } from '#core/models/ExportFormat.js';
+import { RequestFilters } from '#core/models/RequestFilters.js';
+/**
+ * Controller for request-related HTTP endpoints
+ * Handles HTTP concerns: extraction, sanitization, serialization, formatting
+ */
+export class RequestController {
+  constructor(requestService, exportService, serializationLib, logger) {
+    this.requestService = requestService;
+    this.exportService = exportService;
+    this.serializationLib = serializationLib;
+    this.logger = logger;
+  }
+  /**
+   * Sanitize search parameter
+   */
+  _sanitizeSearch(value) {
+    if (value !== undefined && value !== null) {
+      const trimmed = String(value).trim();
+      return trimmed.length > 0 ? trimmed : null;
+    }
+    return null;
+  }
+  /**
+   * Extract and sanitize filters from HTTP query
+   */
+  _extractFilters(reqQuery) {
+    return new RequestFilters({
+      sessionId: reqQuery.sessionId ? String(reqQuery.sessionId).trim() : null,
+      direction: reqQuery.direction ? String(reqQuery.direction).trim() : null,
+      method: reqQuery.method ? String(reqQuery.method).trim() : null,
+      jsonrpcMethod: reqQuery.jsonrpcMethod ? String(reqQuery.jsonrpcMethod).trim() : null,
+      statusCode: reqQuery.statusCode ? Number.parseInt(reqQuery.statusCode) : null,
+      jsonrpcId: reqQuery.jsonrpcId ? String(reqQuery.jsonrpcId).trim() : null,
+      search: this._sanitizeSearch(reqQuery.search),
+      serverName: reqQuery.serverName ? String(reqQuery.serverName).trim() : null,
+      startTime: reqQuery.startTime || null,
+      endTime: reqQuery.endTime || null,
+      limit: reqQuery.limit,
+      offset: reqQuery.offset,
+    });
+  }
+  /**
+   * GET /api/requests
+   */
+  getRequests(req, res) {
+    try {
+      const filters = this._extractFilters(req.query);
+      const requests = this.requestService.getRequests(filters);
+      const serialized = this.serializationLib.serializeBigInt(requests);
+      res.json(serialized);
+    } catch (error) {
+      this.logger.error({ error: error.message }, 'Error in getRequests');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to query requests',
+        details: error.message,
+      });
+    }
+  }
+  /**
+   * GET /api/requests/:frameNumber
+   */
+  getRequest(req, res) {
+    try {
+      const request = this.requestService.getRequest(req.params.frameNumber);
+      if (!request) {
+        return res.status(StatusCodes.NOT_FOUND).json({ error: 'Request not found' });
+      }
+      const serialized = this.serializationLib.serializeBigInt(request);
+      res.json(serialized);
+    } catch (error) {
+      this.logger.error({ error: error.message }, 'Error in getRequest');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to get request',
+        details: error.message,
+      });
+    }
+  }
+  /**
+   * POST /api/requests/clear
+   */
+  clearRequests(_req, res) {
+    try {
+      const result = this.requestService.clearRequests();
+      res.json({
+        success: true,
+        message: `Cleared ${result.clearedTables.length} table(s): ${result.clearedTables.join(', ')}. All captured traffic has been cleared.`,
+      });
+    } catch (error) {
+      this.logger.error({ error: error.message }, 'Error clearing requests');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to clear traffic',
+        details: error.message,
+      });
+    }
+  }
+  /**
+   * GET /api/requests/export
+   */
+  exportRequests(req, res) {
+    try {
+      const format = req.query.format || ExportFormat.JSON;
+      const filters = this._extractFilters(req.query);
+      const requests = this.requestService.getRequestsForExport(filters);
+      const result = this.exportService.exportRequests(requests, format, this.serializationLib);
+      const filename = `mcp-shark-traffic-${new Date().toISOString().replace(/[:.]/g, '-')}.${result.extension}`;
+      res.setHeader('Content-Type', result.contentType);
+      res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+      res.send(result.content);
+    } catch (error) {
+      this.logger.error({ error: error.message }, 'Error exporting requests');
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({
+        error: 'Failed to export traffic',
+        details: error.message,
+      });
+    }
+  }
+}

package/ui/server/controllers/ScanController.js ADDED Viewed

@@ -0,0 +1,122 @@
+import { StatusCodes } from '#core/constants/index.js';
+import { handleError, handleValidationError } from '../utils/errorHandler.js';
+/**
+ * Controller for Smart Scan HTTP endpoints
+ */
+export class ScanController {
+  constructor(scanService, scanCacheService, logger) {
+    this.scanService = scanService;
+    this.scanCacheService = scanCacheService;
+    this.logger = logger;
+  }
+  createScan = async (req, res) => {
+    try {
+      const { apiToken, scanData } = req.body;
+      if (!apiToken) {
+        return handleValidationError('API token is required', res, this.logger);
+      }
+      if (!scanData) {
+        return handleValidationError('Scan data is required', res, this.logger);
+      }
+      const result = await this.scanService.createScan(scanData, apiToken);
+      return res.status(result.status).json(result.data || { error: result.error });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Smart Scan API error');
+    }
+  };
+  createBatchScans = async (req, res) => {
+    try {
+      const { apiToken, servers } = req.body;
+      if (!apiToken) {
+        return handleValidationError('API token is required', res, this.logger);
+      }
+      if (!servers || !Array.isArray(servers) || servers.length === 0) {
+        return handleValidationError('Servers array is required', res, this.logger);
+      }
+      const results = await this.scanService.createBatchScans(servers, apiToken);
+      return res.json({
+        success: true,
+        results,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Smart Scan batch API error');
+    }
+  };
+  getScan = async (req, res) => {
+    try {
+      const { scanId } = req.params;
+      const apiToken = req.headers.authorization?.replace('Bearer ', '');
+      if (!apiToken) {
+        return res.status(StatusCodes.UNAUTHORIZED).json({
+          error: 'API token is required',
+        });
+      }
+      if (!scanId) {
+        return res.status(StatusCodes.BAD_REQUEST).json({
+          error: 'Scan ID is required',
+        });
+      }
+      const result = await this.scanService.getScan(scanId, apiToken);
+      return res.status(result.status).json(result.data || { error: result.error });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Smart Scan API error');
+    }
+  };
+  listScans = (_req, res) => {
+    try {
+      const cachedScans = this.scanCacheService.getAllCachedScanResults();
+      return res.json({
+        scans: cachedScans,
+        cached: true,
+        count: cachedScans.length,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error loading cached scans');
+    }
+  };
+  getCachedResults = (req, res) => {
+    try {
+      const { servers } = req.body;
+      if (!servers || !Array.isArray(servers) || servers.length === 0) {
+        return handleValidationError('Servers array is required', res, this.logger);
+      }
+      const results = this.scanService.getCachedResults(servers);
+      return res.json({
+        success: true,
+        results,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error getting cached results');
+    }
+  };
+  clearCache = (_req, res) => {
+    try {
+      const deletedCount = this.scanCacheService.clearAllScanResults();
+      return res.json({
+        success: true,
+        message: `Cleared ${deletedCount} cached scan result${deletedCount !== 1 ? 's' : ''}`,
+        deletedCount,
+      });
+    } catch (error) {
+      handleError(error, res, this.logger, 'Error clearing cache');
+    }
+  };
+}