npm - @mcp-shark/mcp-shark - Versions diffs - 1.4.2 → 1.5.0 - Mend

@mcp-shark/mcp-shark 1.4.2 → 1.5.0

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 (203) hide show

package/README.md +84 -645
package/bin/mcp-shark.js +30 -36
package/mcp-server/index.js +115 -0
package/mcp-server/lib/auditor/audit.js +22 -38
package/mcp-server/lib/common/error.js +1 -1
package/mcp-server/lib/server/external/all.js +5 -6
package/mcp-server/lib/server/external/config.js +1 -3
package/mcp-server/lib/server/external/kv.js +4 -12
package/mcp-server/lib/server/external/single/request.js +3 -6
package/mcp-server/lib/server/external/single/run.js +8 -19
package/mcp-server/lib/server/internal/handlers/prompts-get.js +3 -13
package/mcp-server/lib/server/internal/handlers/prompts-list.js +2 -6
package/mcp-server/lib/server/internal/handlers/resources-list.js +2 -6
package/mcp-server/lib/server/internal/handlers/resources-read.js +3 -12
package/mcp-server/lib/server/internal/handlers/tools-call.js +3 -9
package/mcp-server/lib/server/internal/handlers/tools-list.js +2 -2
package/mcp-server/lib/server/internal/run.js +4 -16
package/mcp-server/lib/server/internal/server.js +6 -7
package/mcp-server/lib/server/internal/session.js +2 -15
package/mcp-server/mcp-shark.js +16 -66
package/package.json +23 -38
package/ui/dist/assets/index-Cc-IUa83.css +1 -0
package/ui/dist/assets/index-srLDlk97.js +35 -0
package/ui/dist/index.html +17 -0
package/ui/dist/og-image.png +0 -0
package/ui/server/routes/backups/deleteBackup.js +54 -0
package/ui/server/routes/backups/index.js +15 -0
package/ui/server/routes/backups/listBackups.js +75 -0
package/ui/server/routes/backups/restoreBackup.js +83 -0
package/ui/server/routes/backups/viewBackup.js +47 -0
package/ui/server/routes/composite/index.js +46 -0
package/ui/server/routes/composite/servers.js +18 -0
package/ui/server/routes/composite/setup.js +129 -0
package/ui/server/routes/composite/status.js +7 -0
package/ui/server/routes/composite/stop.js +39 -0
package/ui/server/routes/composite/utils.js +45 -0
package/ui/server/routes/config.js +34 -30
package/ui/server/routes/conversations.js +3 -3
package/ui/server/routes/help.js +2 -2
package/ui/server/routes/logs.js +5 -5
package/ui/server/routes/playground.js +45 -47
package/ui/server/routes/requests.js +112 -108
package/ui/server/routes/sessions.js +4 -4
package/ui/server/routes/settings.js +199 -0
package/ui/server/routes/smartscan/discover.js +7 -6
package/ui/server/routes/smartscan/scans/clearCache.js +3 -2
package/ui/server/routes/smartscan/scans/createBatchScans.js +4 -3
package/ui/server/routes/smartscan/scans/createScan.js +2 -1
package/ui/server/routes/smartscan/scans/getCachedResults.js +2 -1
package/ui/server/routes/smartscan/scans/getScan.js +2 -1
package/ui/server/routes/smartscan/scans/listScans.js +5 -4
package/ui/server/routes/smartscan/scans.js +3 -3
package/ui/server/routes/smartscan/token.js +4 -3
package/ui/server/routes/smartscan/transport.js +1 -1
package/ui/server/routes/smartscan.js +1 -1
package/ui/server/routes/statistics.js +13 -10
package/ui/server/utils/config-update.js +7 -6
package/ui/server/utils/config.js +4 -4
package/ui/server/utils/logger.js +2 -0
package/ui/server/utils/paths.js +210 -2
package/ui/server/utils/port.js +2 -2
package/ui/server/utils/process.js +0 -67
package/ui/server/utils/scan-cache/all-results.js +76 -59
package/ui/server/utils/scan-cache/directory.js +1 -1
package/ui/server/utils/scan-cache/file-operations.js +19 -16
package/ui/server/utils/scan-cache/server-operations.js +14 -9
package/ui/server/utils/serialization.js +9 -3
package/ui/server/utils/smartscan-token.js +4 -3
package/ui/server.js +86 -41
package/ui/src/App.jsx +5 -5
package/ui/src/CompositeLogs.jsx +20 -20
package/ui/src/CompositeSetup.jsx +9 -9
package/ui/src/HelpGuide/HelpGuideFooter.jsx +1 -0
package/ui/src/HelpGuide/HelpGuideHeader.jsx +2 -1
package/ui/src/HelpGuide.jsx +17 -4
package/ui/src/IntroTour.jsx +19 -5
package/ui/src/LogDetail.jsx +1 -0
package/ui/src/LogTable.jsx +24 -6
package/ui/src/PacketDetail.jsx +21 -16
package/ui/src/PacketFilters.jsx +29 -14
package/ui/src/PacketList.jsx +4 -5
package/ui/src/SmartScan.jsx +5 -5
package/ui/src/TabNavigation.jsx +5 -5
package/ui/src/components/App/HelpButton.jsx +4 -0
package/ui/src/components/App/TrafficTab.jsx +4 -4
package/ui/src/components/App/useAppState.js +118 -24
package/ui/src/components/BackupList.jsx +6 -2
package/ui/src/components/CollapsibleSection.jsx +16 -2
package/ui/src/components/ConfigViewerModal.jsx +17 -3
package/ui/src/components/ConfirmationModal.jsx +20 -3
package/ui/src/components/DetailsTab/BodySection.jsx +3 -1
package/ui/src/components/DetailsTab/CollapsibleRequestResponse.jsx +14 -3
package/ui/src/components/DetailsTab/InfoSection.jsx +4 -2
package/ui/src/components/DetailsTab/RequestDetailsSection.jsx +7 -5
package/ui/src/components/DetailsTab/ResponseDetailsSection.jsx +7 -5
package/ui/src/components/DetectedPathsList.jsx +5 -2
package/ui/src/components/FileInput.jsx +3 -1
package/ui/src/components/GroupHeader.jsx +14 -0
package/ui/src/components/GroupedByMcpView.jsx +3 -4
package/ui/src/components/GroupedByServerView.jsx +1 -1
package/ui/src/components/GroupedBySessionView.jsx +1 -1
package/ui/src/components/HexTab.jsx +17 -4
package/ui/src/components/LogsToolbar.jsx +3 -1
package/ui/src/components/McpPlayground/LoadingModal.jsx +7 -3
package/ui/src/components/McpPlayground/PromptsSection/PromptCallPanel.jsx +5 -0
package/ui/src/components/McpPlayground/PromptsSection/PromptItem.jsx +6 -2
package/ui/src/components/McpPlayground/PromptsSection/PromptsList.jsx +4 -4
package/ui/src/components/McpPlayground/PromptsSection.jsx +2 -1
package/ui/src/components/McpPlayground/ResourcesSection/ResourceCallPanel.jsx +3 -0
package/ui/src/components/McpPlayground/ResourcesSection/ResourceItem.jsx +6 -2
package/ui/src/components/McpPlayground/ResourcesSection/ResourcesList.jsx +4 -4
package/ui/src/components/McpPlayground/ResourcesSection.jsx +2 -1
package/ui/src/components/McpPlayground/ToolsSection/ToolCallPanel.jsx +5 -0
package/ui/src/components/McpPlayground/ToolsSection/ToolItem.jsx +6 -2
package/ui/src/components/McpPlayground/ToolsSection/ToolsList.jsx +4 -4
package/ui/src/components/McpPlayground/ToolsSection.jsx +2 -1
package/ui/src/components/McpPlayground/hooks/useMcpDataLoader.js +9 -9
package/ui/src/components/McpPlayground/hooks/useMcpRequest.js +10 -5
package/ui/src/components/McpPlayground/hooks/useMcpServerStatus.js +43 -23
package/ui/src/components/McpPlayground/useMcpPlayground.js +72 -44
package/ui/src/components/McpPlayground.jsx +5 -2
package/ui/src/components/PacketDetailHeader.jsx +8 -3
package/ui/src/components/PacketFilters/ExportControls.jsx +2 -1
package/ui/src/components/PacketFilters/FilterInput.jsx +1 -1
package/ui/src/components/RawTab.jsx +15 -2
package/ui/src/components/RequestRow/OrphanedResponseRow.jsx +10 -2
package/ui/src/components/RequestRow/RequestRowMain.jsx +12 -3
package/ui/src/components/RequestRow/ResponseRow.jsx +11 -3
package/ui/src/components/RequestRow.jsx +17 -9
package/ui/src/components/ServerControl.jsx +3 -1
package/ui/src/components/ServiceSelector.jsx +2 -0
package/ui/src/components/SmartScan/AnalysisResult.jsx +2 -2
package/ui/src/components/SmartScan/BatchResultsDisplay/BatchResultItem.jsx +2 -1
package/ui/src/components/SmartScan/BatchResultsDisplay/BatchResultsHeader.jsx +1 -1
package/ui/src/components/SmartScan/BatchResultsDisplay.jsx +9 -3
package/ui/src/components/SmartScan/EmptyState.jsx +3 -0
package/ui/src/components/SmartScan/ErrorDisplay.jsx +4 -2
package/ui/src/components/SmartScan/ExpandableSection.jsx +4 -0
package/ui/src/components/SmartScan/FindingsTable.jsx +46 -42
package/ui/src/components/SmartScan/ListViewContent.jsx +2 -2
package/ui/src/components/SmartScan/NotablePatternsSection.jsx +13 -8
package/ui/src/components/SmartScan/OverallSummarySection.jsx +36 -29
package/ui/src/components/SmartScan/RecommendationsSection.jsx +10 -8
package/ui/src/components/SmartScan/ScanDetailHeader.jsx +2 -1
package/ui/src/components/SmartScan/ScanDetailView.jsx +4 -4
package/ui/src/components/SmartScan/ScanListView/ScanListHeader.jsx +2 -1
package/ui/src/components/SmartScan/ScanListView/ScanListItem.jsx +15 -1
package/ui/src/components/SmartScan/ScanOverviewSection.jsx +3 -1
package/ui/src/components/SmartScan/ScanResultsDisplay.jsx +1 -1
package/ui/src/components/SmartScan/ScanViewContent.jsx +2 -2
package/ui/src/components/SmartScan/ScanningProgress.jsx +4 -2
package/ui/src/components/SmartScan/ServerInfoSection.jsx +3 -1
package/ui/src/components/SmartScan/ServerSelectionRow.jsx +4 -2
package/ui/src/components/SmartScan/SingleResultDisplay.jsx +5 -3
package/ui/src/components/SmartScan/SmartScanControls.jsx +11 -7
package/ui/src/components/SmartScan/SmartScanHeader.jsx +1 -1
package/ui/src/components/SmartScan/ViewModeTabs.jsx +2 -0
package/ui/src/components/SmartScan/hooks/useCacheManagement.js +1 -2
package/ui/src/components/SmartScan/hooks/useMcpDiscovery.js +22 -26
package/ui/src/components/SmartScan/hooks/useScanList.js +10 -9
package/ui/src/components/SmartScan/hooks/useScanOperations.js +23 -14
package/ui/src/components/SmartScan/hooks/useServerStatus.js +2 -2
package/ui/src/components/SmartScan/hooks/useTokenManagement.js +2 -2
package/ui/src/components/SmartScan/scanDataUtils.js +22 -17
package/ui/src/components/SmartScan/useSmartScan.js +4 -4
package/ui/src/components/SmartScan/utils.js +3 -1
package/ui/src/components/SmartScanIcons.jsx +6 -3
package/ui/src/components/TabNavigation/DesktopTabs.jsx +8 -3
package/ui/src/components/TabNavigation/MobileDropdown.jsx +3 -1
package/ui/src/components/TabNavigation.jsx +8 -3
package/ui/src/components/TabNavigationIcons.jsx +4 -4
package/ui/src/components/TourOverlay.jsx +1 -1
package/ui/src/components/TourTooltip/TourTooltipButtons.jsx +3 -0
package/ui/src/components/TourTooltip/TourTooltipHeader.jsx +1 -0
package/ui/src/components/TourTooltip/TourTooltipIcons.jsx +9 -0
package/ui/src/components/TourTooltip/useTooltipPosition.js +63 -36
package/ui/src/components/TourTooltip.jsx +11 -3
package/ui/src/components/ViewModeTabs.jsx +3 -1
package/ui/src/config/tourSteps.jsx +0 -2
package/ui/src/hooks/useAnimation.js +15 -12
package/ui/src/hooks/useConfigManagement.js +8 -8
package/ui/src/hooks/useServiceExtraction.js +1 -1
package/ui/src/index.css +3 -8
package/ui/src/theme.js +3 -3
package/ui/src/utils/hexUtils.js +11 -5
package/ui/src/utils/mcpGroupingUtils.js +18 -10
package/ui/src/utils/requestPairing.js +89 -0
package/ui/src/utils/requestUtils.js +32 -101
package/ui/vite.config.js +1 -1
package/mcp-server/.editorconfig +0 -15
package/mcp-server/.prettierignore +0 -11
package/mcp-server/.prettierrc +0 -12
package/mcp-server/README.md +0 -280
package/mcp-server/commitlint.config.cjs +0 -42
package/mcp-server/eslint.config.js +0 -131
package/mcp-server/package-lock.json +0 -4784
package/mcp-server/package.json +0 -30
package/ui/README.md +0 -212
package/ui/package-lock.json +0 -3574
package/ui/package.json +0 -12
package/ui/paths.js +0 -282
package/ui/server/routes/backups.js +0 -251
package/ui/server/routes/composite.js +0 -260

package/ui/dist/index.html ADDED Viewed

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="MCP Shark - Wireshark-like forensic analysis tool for Model Context Protocol communications" />
+    <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-srLDlk97.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Cc-IUa83.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/ui/dist/og-image.png ADDED Viewed

Binary file

package/ui/server/routes/backups/deleteBackup.js ADDED Viewed

@@ -0,0 +1,54 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+export function deleteBackup(req, res, mcpSharkLogs, broadcastLogUpdate) {
+  try {
+    const { backupPath } = req.body;
+    if (!backupPath) {
+      return res.status(400).json({ error: 'backupPath is required' });
+    }
+    const resolvedBackupPath = backupPath.startsWith('~')
+      ? path.join(homedir(), backupPath.slice(1))
+      : backupPath;
+    if (!fs.existsSync(resolvedBackupPath)) {
+      return res.status(404).json({ error: 'Backup file not found', path: resolvedBackupPath });
+    }
+    fs.unlinkSync(resolvedBackupPath);
+    const timestamp = new Date().toISOString();
+    const deleteLog = {
+      timestamp,
+      type: 'stdout',
+      line: `[DELETE] Deleted backup: ${resolvedBackupPath.replace(homedir(), '~')}`,
+    };
+    mcpSharkLogs.push(deleteLog);
+    if (mcpSharkLogs.length > 10000) {
+      mcpSharkLogs.shift();
+    }
+    broadcastLogUpdate(deleteLog);
+    res.json({
+      success: true,
+      message: 'Backup file deleted successfully',
+      backupPath: resolvedBackupPath.replace(homedir(), '~'),
+    });
+  } catch (error) {
+    const timestamp = new Date().toISOString();
+    const errorLog = {
+      timestamp,
+      type: 'error',
+      line: `[DELETE ERROR] Failed to delete backup: ${error.message}`,
+    };
+    mcpSharkLogs.push(errorLog);
+    if (mcpSharkLogs.length > 10000) {
+      mcpSharkLogs.shift();
+    }
+    broadcastLogUpdate(errorLog);
+    res.status(500).json({ error: 'Failed to delete backup', details: error.message });
+  }
+}

package/ui/server/routes/backups/index.js ADDED Viewed

@@ -0,0 +1,15 @@
+import { deleteBackup } from './deleteBackup.js';
+import { listBackups } from './listBackups.js';
+import { restoreBackup } from './restoreBackup.js';
+import { viewBackup } from './viewBackup.js';
+export function createBackupRoutes() {
+  const router = {};
+  router.listBackups = listBackups;
+  router.restoreBackup = restoreBackup;
+  router.viewBackup = viewBackup;
+  router.deleteBackup = deleteBackup;
+  return router;
+}

package/ui/server/routes/backups/listBackups.js ADDED Viewed

@@ -0,0 +1,75 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+export function listBackups(_req, res) {
+  try {
+    const backups = [];
+    const homeDir = homedir();
+    const commonPaths = [
+      path.join(homeDir, '.cursor', 'mcp.json'),
+      path.join(homeDir, '.codeium', 'windsurf', 'mcp_config.json'),
+    ];
+    const backupDirs = [path.join(homeDir, '.cursor'), path.join(homeDir, '.codeium', 'windsurf')];
+    // Find backups with new format: .mcp.json-mcpshark.<datetime>.json
+    backupDirs.forEach((dir) => {
+      if (fs.existsSync(dir)) {
+        const files = fs.readdirSync(dir);
+        files
+          .filter((file) => {
+            // Match pattern: .<basename>-mcpshark.<datetime>.json
+            return /^\.(.+)-mcpshark\.\d{4}-\d{2}-\d{2}_\d{2}-\d{2}-\d{2}\.json$/.test(file);
+          })
+          .forEach((file) => {
+            const backupPath = path.join(dir, file);
+            // Extract original filename from backup name
+            // .mcp.json-mcpshark.<datetime>.json -> mcp.json
+            const match = file.match(/^\.(.+)-mcpshark\./);
+            if (match) {
+              const originalBasename = match[1];
+              const originalPath = path.join(dir, originalBasename);
+              const stats = fs.statSync(backupPath);
+              backups.push({
+                originalPath: originalPath,
+                backupPath: backupPath,
+                createdAt: stats.birthtime.toISOString(),
+                modifiedAt: stats.mtime.toISOString(),
+                size: stats.size,
+                displayPath: originalPath.replace(homeDir, '~'),
+                backupFileName: file,
+              });
+            }
+          });
+      }
+    });
+    // Also check for old .backup format for backward compatibility
+    commonPaths.forEach((configPath) => {
+      const backupPath = `${configPath}.backup`;
+      if (fs.existsSync(backupPath)) {
+        const stats = fs.statSync(backupPath);
+        backups.push({
+          originalPath: configPath,
+          backupPath: backupPath,
+          createdAt: stats.birthtime.toISOString(),
+          modifiedAt: stats.mtime.toISOString(),
+          size: stats.size,
+          displayPath: configPath.replace(homeDir, '~'),
+          backupFileName: path.basename(backupPath),
+        });
+      }
+    });
+    // Sort by modifiedAt (latest first)
+    res.json({
+      backups: backups.sort(
+        (a, b) => new Date(b.modifiedAt || b.createdAt) - new Date(a.modifiedAt || a.createdAt)
+      ),
+    });
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to list backups', details: error.message });
+  }
+}

package/ui/server/routes/backups/restoreBackup.js ADDED Viewed

@@ -0,0 +1,83 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+export function restoreBackup(req, res, mcpSharkLogs, broadcastLogUpdate) {
+  try {
+    const { backupPath, originalPath } = req.body;
+    if (!backupPath) {
+      return res.status(400).json({ error: 'backupPath is required' });
+    }
+    const resolvedBackupPath = backupPath.startsWith('~')
+      ? path.join(homedir(), backupPath.slice(1))
+      : backupPath;
+    if (!fs.existsSync(resolvedBackupPath)) {
+      return res.status(404).json({ error: 'Backup file not found', path: resolvedBackupPath });
+    }
+    // Determine original path
+    const determineTargetPath = (originalPath, backupPath) => {
+      if (originalPath) {
+        return originalPath.startsWith('~')
+          ? path.join(homedir(), originalPath.slice(1))
+          : originalPath;
+      }
+      // Try to extract from backup filename
+      if (backupPath.endsWith('.backup')) {
+        return backupPath.replace('.backup', '');
+      }
+      // New format: .mcp.json-mcpshark.<datetime>.json
+      const match = path.basename(backupPath).match(/^\.(.+)-mcpshark\./);
+      if (match) {
+        const originalBasename = match[1];
+        return path.join(path.dirname(backupPath), originalBasename);
+      }
+      return null;
+    };
+    const targetPath = determineTargetPath(originalPath, resolvedBackupPath);
+    if (!targetPath) {
+      return res.status(400).json({ error: 'Could not determine original file path' });
+    }
+    const backupContent = fs.readFileSync(resolvedBackupPath, 'utf8');
+    fs.writeFileSync(targetPath, backupContent);
+    const timestamp = new Date().toISOString();
+    const restoreLog = {
+      timestamp,
+      type: 'stdout',
+      line: `[RESTORE] Restored config from backup: ${targetPath.replace(homedir(), '~')}`,
+    };
+    mcpSharkLogs.push(restoreLog);
+    if (mcpSharkLogs.length > 10000) {
+      mcpSharkLogs.shift();
+    }
+    broadcastLogUpdate(restoreLog);
+    res.json({
+      success: true,
+      message: 'Config file restored from backup',
+      originalPath: targetPath.replace(homedir(), '~'),
+    });
+  } catch (error) {
+    const timestamp = new Date().toISOString();
+    const errorLog = {
+      timestamp,
+      type: 'error',
+      line: `[RESTORE ERROR] Failed to restore: ${error.message}`,
+    };
+    mcpSharkLogs.push(errorLog);
+    if (mcpSharkLogs.length > 10000) {
+      mcpSharkLogs.shift();
+    }
+    broadcastLogUpdate(errorLog);
+    res.status(500).json({ error: 'Failed to restore backup', details: error.message });
+  }
+}

package/ui/server/routes/backups/viewBackup.js ADDED Viewed

@@ -0,0 +1,47 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+function tryParseJson(content) {
+  try {
+    return JSON.parse(content);
+  } catch (_e) {
+    return null;
+  }
+}
+export function viewBackup(req, res) {
+  try {
+    const { backupPath } = req.query;
+    if (!backupPath) {
+      return res.status(400).json({ error: 'backupPath is required' });
+    }
+    const resolvedBackupPath = backupPath.startsWith('~')
+      ? path.join(homedir(), backupPath.slice(1))
+      : backupPath;
+    if (!fs.existsSync(resolvedBackupPath)) {
+      return res.status(404).json({ error: 'Backup file not found', path: resolvedBackupPath });
+    }
+    const content = fs.readFileSync(resolvedBackupPath, 'utf-8');
+    const parsed = tryParseJson(content);
+    const stats = fs.statSync(resolvedBackupPath);
+    res.json({
+      success: true,
+      backupPath: resolvedBackupPath,
+      displayPath: resolvedBackupPath.replace(homedir(), '~'),
+      content: content,
+      parsed: parsed,
+      createdAt: stats.birthtime.toISOString(),
+      modifiedAt: stats.mtime.toISOString(),
+      size: stats.size,
+    });
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to read backup file', details: error.message });
+  }
+}

package/ui/server/routes/composite/index.js ADDED Viewed

@@ -0,0 +1,46 @@
+import { getServers } from './servers.js';
+import { setup } from './setup.js';
+import { getStatus } from './status.js';
+import { stop } from './stop.js';
+export function createCompositeRoutes(
+  getMcpSharkProcess,
+  setMcpSharkProcess,
+  mcpSharkLogs,
+  broadcastLogUpdate
+) {
+  const router = {};
+  router.setup = async (req, res) => {
+    return setup(
+      req,
+      res,
+      getMcpSharkProcess,
+      setMcpSharkProcess,
+      mcpSharkLogs,
+      broadcastLogUpdate
+    );
+  };
+  router.stop = async (req, res, restoreOriginalConfig) => {
+    return stop(
+      req,
+      res,
+      restoreOriginalConfig,
+      getMcpSharkProcess,
+      setMcpSharkProcess,
+      mcpSharkLogs,
+      broadcastLogUpdate
+    );
+  };
+  router.getStatus = (req, res) => {
+    return getStatus(req, res, getMcpSharkProcess);
+  };
+  router.getServers = (req, res) => {
+    return getServers(req, res);
+  };
+  return router;
+}

package/ui/server/routes/composite/servers.js ADDED Viewed

@@ -0,0 +1,18 @@
+import * as fs from 'node:fs';
+import { getMcpConfigPath } from 'mcp-shark-common/configs/index.js';
+export function getServers(_req, res) {
+  try {
+    const mcpsJsonPath = getMcpConfigPath();
+    if (!fs.existsSync(mcpsJsonPath)) {
+      return res.json({ servers: [] });
+    }
+    const configContent = fs.readFileSync(mcpsJsonPath, 'utf-8');
+    const config = JSON.parse(configContent);
+    const servers = config.servers ? Object.keys(config.servers) : [];
+    res.json({ servers });
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to get servers', details: error.message });
+  }
+}

package/ui/server/routes/composite/setup.js ADDED Viewed

@@ -0,0 +1,129 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+import { startMcpSharkServer } from '@mcp-shark/mcp-shark/mcp-server';
+import { getMcpConfigPath } from 'mcp-shark-common/configs/index.js';
+import { getSelectedServiceNames, updateConfigFile } from '../../utils/config-update.js';
+import { clearOriginalConfig, convertMcpServersToServers } from '../../utils/config.js';
+import logger from '../../utils/logger.js';
+import { createLogEntry } from '../../utils/process.js';
+import { filterServers, parseJsonConfig, resolveFileData } from './utils.js';
+const MAX_LOG_LINES = 10000;
+export async function setup(
+  req,
+  res,
+  getMcpSharkProcess,
+  setMcpSharkProcess,
+  mcpSharkLogs,
+  broadcastLogUpdate
+) {
+  mcpSharkLogs.length = 0;
+  const logEntry = createLogEntry(mcpSharkLogs, broadcastLogUpdate);
+  try {
+    const { filePath, fileContent, selectedServices } = req.body;
+    if (!filePath && !fileContent) {
+      return res.status(400).json({ error: 'Either filePath or fileContent is required' });
+    }
+    const fileData = resolveFileData(filePath, fileContent);
+    if (!fileData) {
+      const resolvedFilePath = filePath.startsWith('~')
+        ? path.join(homedir(), filePath.slice(1))
+        : filePath;
+      return res.status(404).json({ error: 'File not found', path: resolvedFilePath });
+    }
+    const parseResult = parseJsonConfig(fileData.content);
+    if (!parseResult.config) {
+      return res.status(400).json({
+        error: 'Invalid JSON file',
+        details: parseResult.error ? parseResult.error.message : 'Failed to parse JSON',
+      });
+    }
+    const originalConfig = parseResult.config;
+    const baseConvertedConfig = convertMcpServersToServers(originalConfig);
+    const convertedConfig =
+      selectedServices && Array.isArray(selectedServices) && selectedServices.length > 0
+        ? filterServers(baseConvertedConfig, selectedServices)
+        : baseConvertedConfig;
+    if (Object.keys(convertedConfig.servers).length === 0) {
+      return res.status(400).json({ error: 'No servers found in config' });
+    }
+    const mcpsJsonPath = getMcpConfigPath();
+    fs.writeFileSync(mcpsJsonPath, JSON.stringify(convertedConfig, null, 2));
+    logger.info({ path: mcpsJsonPath }, 'Wrote converted config');
+    const currentServer = getMcpSharkProcess();
+    if (currentServer?.stop) {
+      await currentServer.stop();
+      setMcpSharkProcess(null);
+    }
+    logEntry('info', '[UI Server] Starting MCP-Shark server as library...');
+    logEntry('info', `[UI Server] Config: ${mcpsJsonPath}`);
+    const serverInstance = await startMcpSharkServer({
+      configPath: mcpsJsonPath,
+      port: 9851,
+      onError: (err) => {
+        logEntry('error', `Failed to start mcp-shark server: ${err.message}`);
+        setMcpSharkProcess(null);
+        throw err;
+      },
+      onReady: () => {
+        logEntry('info', 'MCP Shark server is ready!');
+        logger.info('MCP Shark server is ready!');
+      },
+    });
+    setMcpSharkProcess(serverInstance);
+    logger.info('MCP Shark server started successfully');
+    const selectedServiceNames = getSelectedServiceNames(originalConfig, selectedServices);
+    const { updatedConfig, backupPath: createdBackupPath } = updateConfigFile(
+      originalConfig,
+      selectedServiceNames,
+      fileData.resolvedFilePath,
+      fileData.content,
+      mcpSharkLogs,
+      broadcastLogUpdate
+    );
+    if (!fileData.resolvedFilePath) {
+      clearOriginalConfig();
+    }
+    res.json({
+      success: true,
+      message: 'MCP Shark server started successfully and config file updated',
+      convertedConfig,
+      updatedConfig,
+      filePath: fileData.resolvedFilePath || null,
+      backupPath: createdBackupPath || null,
+    });
+  } catch (error) {
+    logger.error({ error: error.message }, 'Error setting up mcp-shark server');
+    const timestamp = new Date().toISOString();
+    const errorLog = {
+      timestamp,
+      type: 'error',
+      line: `[ERROR] Failed to setup mcp-shark server: ${error.message}`,
+    };
+    mcpSharkLogs.push(errorLog);
+    if (mcpSharkLogs.length > MAX_LOG_LINES) {
+      mcpSharkLogs.shift();
+    }
+    broadcastLogUpdate(errorLog);
+    res.status(500).json({ error: 'Failed to setup mcp-shark server', details: error.message });
+  }
+}

package/ui/server/routes/composite/status.js ADDED Viewed

@@ -0,0 +1,7 @@
+export function getStatus(_req, res, getMcpSharkProcess) {
+  const currentServer = getMcpSharkProcess();
+  res.json({
+    running: currentServer !== null,
+    pid: null, // No process PID when using library
+  });
+}

package/ui/server/routes/composite/stop.js ADDED Viewed

@@ -0,0 +1,39 @@
+export async function stop(
+  _req,
+  res,
+  restoreOriginalConfig,
+  getMcpSharkProcess,
+  setMcpSharkProcess,
+  mcpSharkLogs,
+  broadcastLogUpdate
+) {
+  try {
+    const currentServer = getMcpSharkProcess();
+    if (currentServer?.stop) {
+      await currentServer.stop();
+      setMcpSharkProcess(null);
+      const restored = restoreOriginalConfig();
+      if (restored) {
+        const timestamp = new Date().toISOString();
+        const restoreLog = {
+          timestamp,
+          type: 'stdout',
+          line: '[RESTORE] Restored original config',
+        };
+        mcpSharkLogs.push(restoreLog);
+        if (mcpSharkLogs.length > 10000) {
+          mcpSharkLogs.shift();
+        }
+        broadcastLogUpdate(restoreLog);
+      }
+      res.json({ success: true, message: 'MCP Shark server stopped and config restored' });
+    } else {
+      res.json({ success: true, message: 'MCP Shark server was not running' });
+    }
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to stop mcp-shark server', details: error.message });
+  }
+}

package/ui/server/routes/composite/utils.js ADDED Viewed

@@ -0,0 +1,45 @@
+import * as fs from 'node:fs';
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+export function resolveFileData(filePath, fileContent) {
+  if (fileContent) {
+    const resolvedFilePath = filePath
+      ? filePath.startsWith('~')
+        ? path.join(homedir(), filePath.slice(1))
+        : filePath
+      : null;
+    return { content: fileContent, resolvedFilePath };
+  }
+  const resolvedFilePath = filePath.startsWith('~')
+    ? path.join(homedir(), filePath.slice(1))
+    : filePath;
+  if (!fs.existsSync(resolvedFilePath)) {
+    return null;
+  }
+  return {
+    content: fs.readFileSync(resolvedFilePath, 'utf-8'),
+    resolvedFilePath,
+  };
+}
+export function parseJsonConfig(content) {
+  try {
+    return { config: JSON.parse(content), error: null };
+  } catch (e) {
+    return { config: null, error: e };
+  }
+}
+export function filterServers(config, services) {
+  const filteredServers = {};
+  services.forEach((serviceName) => {
+    if (config.servers[serviceName]) {
+      filteredServers[serviceName] = config.servers[serviceName];
+    }
+  });
+  return { servers: filteredServers };
+}

package/ui/server/routes/config.js CHANGED Viewed

@@ -1,8 +1,35 @@
-import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { homedir } from 'node:os';
-import { extractServices, convertMcpServersToServers } from '../utils/config.js';
-import { createBackupRoutes } from './backups.js';
+import * as path from 'node:path';
+import { extractServices } from '../utils/config.js';
+import { createBackupRoutes } from './backups/index.js';
+function readFileContent(filePath) {
+  const resolvedFilePath = filePath.startsWith('~')
+    ? path.join(homedir(), filePath.slice(1))
+    : filePath;
+  if (!fs.existsSync(resolvedFilePath)) {
+    return null;
+  }
+  return fs.readFileSync(resolvedFilePath, 'utf-8');
+}
+function parseJsonSafely(content) {
+  try {
+    return { config: JSON.parse(content), error: null };
+  } catch (e) {
+    return { config: null, error: e };
+  }
+}
+function tryParseJson(content) {
+  try {
+    return JSON.parse(content);
+  } catch (_e) {
+    return null;
+  }
+}
 export function createConfigRoutes() {
   const router = {};
@@ -15,18 +42,7 @@ export function createConfigRoutes() {
         return res.status(400).json({ error: 'Either filePath or fileContent is required' });
       }
-      const content = fileContent
-        ? fileContent
-        : (() => {
-            const resolvedFilePath = filePath.startsWith('~')
-              ? path.join(homedir(), filePath.slice(1))
-              : filePath;
-            if (!fs.existsSync(resolvedFilePath)) {
-              return null;
-            }
-            return fs.readFileSync(resolvedFilePath, 'utf-8');
-          })();
+      const content = fileContent ? fileContent : readFileContent(filePath);
       if (!content) {
         const resolvedFilePath = filePath.startsWith('~')
@@ -35,13 +51,7 @@ export function createConfigRoutes() {
         return res.status(404).json({ error: 'File not found', path: resolvedFilePath });
       }
-      const parseResult = (() => {
-        try {
-          return { config: JSON.parse(content), error: null };
-        } catch (e) {
-          return { config: null, error: e };
-        }
-      })();
+      const parseResult = parseJsonSafely(content);
       if (!parseResult.config) {
         return res.status(400).json({
@@ -76,13 +86,7 @@ export function createConfigRoutes() {
       }
       const content = fs.readFileSync(resolvedPath, 'utf-8');
-      const parsed = (() => {
-        try {
-          return JSON.parse(content);
-        } catch (e) {
-          return null;
-        }
-      })();
+      const parsed = tryParseJson(content);
       res.json({
         success: true,
@@ -97,7 +101,7 @@ export function createConfigRoutes() {
     }
   };
-  router.detectConfig = (req, res) => {
+  router.detectConfig = (_req, res) => {
     const detected = [];
     const platform = process.platform;
     const homeDir = homedir();