@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/src/lib/context/mcp-optimizer.js

@@ -0,0 +1,200 @@
+/**
+ * MCP Optimizer — Analyze and optimize MCP server configurations
+ *
+ * Reads .claude/settings.json (or .claude/settings.local.json),
+ * detects unused MCP servers based on analytics,
+ * estimates token savings per server, and generates recommendations.
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+const SETTINGS_PATHS = [
+  join(process.cwd(), '.claude/settings.local.json'),
+  join(process.cwd(), '.claude/settings.json'),
+  join(process.env.USERPROFILE || process.env.HOME || '', '.claude/settings.json')
+];
+
+// Estimated token overhead per MCP server in context window
+const MCP_TOKEN_OVERHEAD = {
+  default: 3000,    // average per server
+  heavy: 8000,      // known heavy servers (filesystem, database)
+  light: 1500       // known light servers (simple tools)
+};
+
+const HEAVY_SERVERS = ['filesystem', 'postgres', 'sqlite', 'mysql', 'mongodb'];
+const LIGHT_SERVERS = ['time', 'echo', 'fetch'];
+
+// ============================================================================
+// Settings Loading
+// ============================================================================
+
+/**
+ * Load Claude settings file
+ * @returns {Object|null} Settings object or null
+ */
+export function loadClaudeSettings() {
+  for (const path of SETTINGS_PATHS) {
+    if (existsSync(path)) {
+      try {
+        return { settings: JSON.parse(readFileSync(path, 'utf8')), path };
+      } catch {
+        continue;
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Extract MCP server list from settings
+ * @param {Object} settings - Claude settings object
+ * @returns {Array} Array of { name, config } objects
+ */
+export function extractMCPServers(settings) {
+  const servers = [];
+
+  // Claude settings format: mcpServers: { name: { command, args, env } }
+  if (settings.mcpServers) {
+    for (const [name, config] of Object.entries(settings.mcpServers)) {
+      servers.push({ name, config });
+    }
+  }
+
+  return servers;
+}
+
+// ============================================================================
+// Usage Analysis
+// ============================================================================
+
+/**
+ * Detect unused MCP servers by checking analytics logs
+ * @param {Array} servers - Array of MCP server descriptors
+ * @param {number} [lookbackDays=30] - Days to look back in analytics
+ * @returns {Array} servers with usage stats added
+ */
+export function detectUnusedServers(servers, lookbackDays = 30) {
+  // Read analytics for MCP tool usage patterns
+  const analyticsPath = join(process.cwd(), '.morph/analytics/threads-log.jsonl');
+  const usedServerNames = new Set();
+
+  if (existsSync(analyticsPath)) {
+    try {
+      const cutoff = new Date();
+      cutoff.setDate(cutoff.getDate() - lookbackDays);
+
+      const lines = readFileSync(analyticsPath, 'utf8').trim().split('\n').filter(Boolean);
+      for (const line of lines) {
+        try {
+          const event = JSON.parse(line);
+          if (event.timestamp && new Date(event.timestamp) > cutoff) {
+            // Check for MCP tool references in event data
+            const eventStr = JSON.stringify(event);
+            for (const server of servers) {
+              if (eventStr.includes(server.name)) {
+                usedServerNames.add(server.name);
+              }
+            }
+          }
+        } catch {
+          // Skip malformed lines
+        }
+      }
+    } catch {
+      // Analytics not available — mark all as unknown usage
+    }
+  }
+
+  return servers.map(server => {
+    const isHeavy = HEAVY_SERVERS.some(h => server.name.toLowerCase().includes(h));
+    const isLight = LIGHT_SERVERS.some(l => server.name.toLowerCase().includes(l));
+    const overhead = isHeavy ? MCP_TOKEN_OVERHEAD.heavy : isLight ? MCP_TOKEN_OVERHEAD.light : MCP_TOKEN_OVERHEAD.default;
+
+    const usageSeen = usedServerNames.has(server.name);
+
+    return {
+      ...server,
+      overhead,
+      usageSeen,
+      usageStatus: usedServerNames.size === 0 ? 'unknown' : (usageSeen ? 'used' : 'unused')
+    };
+  });
+}
+
+// ============================================================================
+// Recommendations
+// ============================================================================
+
+/**
+ * Analyze MCP configuration and generate optimization recommendations
+ * @returns {Object} Analysis results with recommendations
+ */
+export function analyzeMCP() {
+  const result = loadClaudeSettings();
+
+  if (!result) {
+    return {
+      found: false,
+      message: 'No Claude settings file found. Checked: .claude/settings.json and .claude/settings.local.json',
+      servers: [],
+      recommendations: []
+    };
+  }
+
+  const { settings, path: settingsPath } = result;
+  const servers = extractMCPServers(settings);
+
+  if (servers.length === 0) {
+    return {
+      found: true,
+      settingsPath,
+      servers: [],
+      totalOverhead: 0,
+      recommendations: [],
+      message: 'No MCP servers configured.'
+    };
+  }
+
+  const analyzedServers = detectUnusedServers(servers);
+  const totalOverhead = analyzedServers.reduce((sum, s) => sum + s.overhead, 0);
+
+  const unusedServers = analyzedServers.filter(s => s.usageStatus === 'unused');
+  const unusedOverhead = unusedServers.reduce((sum, s) => sum + s.overhead, 0);
+
+  const recommendations = [];
+
+  if (unusedServers.length > 0) {
+    recommendations.push({
+      type: 'disable_unused',
+      title: `Disable ${unusedServers.length} unused MCP server(s)`,
+      description: `${unusedServers.map(s => s.name).join(', ')} have not been used recently.`,
+      estimatedSavings: unusedOverhead,
+      servers: unusedServers.map(s => s.name),
+      action: 'Remove from mcpServers in .claude/settings.json'
+    });
+  }
+
+  const heavyServers = analyzedServers.filter(s => s.overhead >= MCP_TOKEN_OVERHEAD.heavy && s.usageStatus !== 'unused');
+  if (heavyServers.length > 0) {
+    recommendations.push({
+      type: 'defer_heavy',
+      title: `Consider deferring ${heavyServers.length} heavy MCP server(s)`,
+      description: `${heavyServers.map(s => s.name).join(', ')} use significant context window space.`,
+      estimatedSavings: heavyServers.reduce((sum, s) => sum + s.overhead, 0) / 2,
+      servers: heavyServers.map(s => s.name),
+      action: 'Only enable when needed for that specific task'
+    });
+  }
+
+  return {
+    found: true,
+    settingsPath,
+    servers: analyzedServers,
+    totalServers: servers.length,
+    totalOverhead,
+    unusedCount: unusedServers.length,
+    potentialSavings: unusedOverhead,
+    recommendations: recommendations.sort((a, b) => b.estimatedSavings - a.estimatedSavings)
+  };
+}

package/src/lib/detectors/config-detector.js

@@ -1,223 +1,223 @@
-/**
- * Config Detector - Reads configuration files to extract technologies, versions, and dependencies
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { glob } from 'glob';
-
-/**
- * Detect project configuration
- * @param {string} projectPath - Project root path
- * @returns {Promise<Object>} Configuration detection results
- */
-export async function detectConfig(projectPath) {
-  const result = {
-    language: 'unknown',
-    version: null,
-    packageManager: 'unknown',
-    dependencies: [],
-    technologies: [],
-    auth: null,
-    database: null,
-    hosting: null
-  };
-
-  // Detect .NET projects
-  const dotnetConfig = await detectDotNet(projectPath);
-  if (dotnetConfig) {
-    Object.assign(result, dotnetConfig);
-    return result;
-  }
-
-  // Detect Node.js projects
-  const nodeConfig = await detectNode(projectPath);
-  if (nodeConfig) {
-    Object.assign(result, nodeConfig);
-    return result;
-  }
-
-  return result;
-}
-
-/**
- * Detect .NET configuration
- */
-async function detectDotNet(projectPath) {
-  const programCs = join(projectPath, 'Program.cs');
-  const csprojFiles = await glob('**/*.csproj', { cwd: projectPath });
-
-  if (!existsSync(programCs) && csprojFiles.length === 0) {
-    return null;
-  }
-
-  const config = {
-    language: 'csharp',
-    version: null,
-    packageManager: 'dotnet',
-    dependencies: [],
-    technologies: [],
-    auth: null,
-    database: null,
-    hosting: null
-  };
-
-  // Read Program.cs
-  if (existsSync(programCs)) {
-    const content = readFileSync(programCs, 'utf8');
-
-    // Detect .NET version
-    if (content.includes('WebApplication.CreateBuilder') || content.includes('.NET')) {
-      config.version = detectDotNetVersion(content);
-    }
-
-    // Detect technologies from Program.cs
-    config.technologies = detectTechnologiesFromProgramCs(content);
-    config.auth = detectAuthMethod(content);
-    config.database = detectDatabase(content);
-    config.hosting = detectHosting(content);
-  }
-
-  // Read .csproj files
-  for (const csprojFile of csprojFiles.slice(0, 3)) { // Read first 3 csproj files
-    const csprojPath = join(projectPath, csprojFile);
-    const content = readFileSync(csprojPath, 'utf8');
-
-    config.dependencies.push(...extractNuGetPackages(content));
-  }
-
-  // Remove duplicates
-  config.dependencies = [...new Set(config.dependencies)];
-  config.technologies = [...new Set(config.technologies)];
-
-  return config;
-}
-
-/**
- * Detect Node.js configuration
- */
-async function detectNode(projectPath) {
-  const packageJsonPath = join(projectPath, 'package.json');
-
-  if (!existsSync(packageJsonPath)) {
-    return null;
-  }
-
-  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-
-  const config = {
-    language: 'javascript',
-    version: packageJson.engines?.node || null,
-    packageManager: existsSync(join(projectPath, 'yarn.lock')) ? 'yarn' :
-                    existsSync(join(projectPath, 'pnpm-lock.yaml')) ? 'pnpm' : 'npm',
-    dependencies: [],
-    technologies: [],
-    auth: null,
-    database: null,
-    hosting: null
-  };
-
-  // Extract dependencies
-  const allDeps = {
-    ...packageJson.dependencies,
-    ...packageJson.devDependencies
-  };
-
-  config.dependencies = Object.keys(allDeps);
-
-  // Detect technologies
-  if (allDeps['next']) config.technologies.push('Next.js');
-  if (allDeps['react']) config.technologies.push('React');
-  if (allDeps['@clerk/nextjs']) config.auth = 'Clerk';
-  if (allDeps['prisma']) config.database = 'Prisma';
-
-  return config;
-}
-
-/**
- * Detect .NET version from Program.cs
- */
-function detectDotNetVersion(content) {
-  if (content.includes('.NET 10') || content.includes('net10.0')) return '.NET 10';
-  if (content.includes('.NET 9') || content.includes('net9.0')) return '.NET 9';
-  if (content.includes('.NET 8') || content.includes('net8.0')) return '.NET 8';
-  return 'unknown';
-}
-
-/**
- * Detect technologies from Program.cs
- */
-function detectTechnologiesFromProgramCs(content) {
-  const techs = [];
-
-  if (content.includes('AddBlazor') || content.includes('MapBlazorHub')) {
-    techs.push('Blazor Server');
-  }
-
-  if (content.includes('AddHangfire')) {
-    techs.push('Hangfire');
-  }
-
-  if (content.includes('IChatClient') || content.includes('Microsoft.Agents')) {
-    techs.push('Microsoft Agent Framework');
-  }
-
-  if (content.includes('AddDbContext') || content.includes('UseSqlServer')) {
-    techs.push('Entity Framework Core');
-  }
-
-  if (content.includes('AddFluentUIComponents') || content.includes('FluentUI')) {
-    techs.push('Fluent UI Blazor');
-  }
-
-  if (content.includes('AddMudServices') || content.includes('MudBlazor')) {
-    techs.push('MudBlazor');
-  }
-
-  return techs;
-}
-
-/**
- * Detect authentication method
- */
-function detectAuthMethod(content) {
-  if (content.includes('AddClerk') || content.includes('Clerk')) return 'Clerk';
-  if (content.includes('AddMicrosoftIdentity') || content.includes('Entra')) return 'Microsoft Entra';
-  if (content.includes('AddAuthentication')) return 'ASP.NET Identity';
-  return null;
-}
-
-/**
- * Detect database
- */
-function detectDatabase(content) {
-  if (content.includes('UseSqlServer')) return 'SQL Server';
-  if (content.includes('UsePostgres')) return 'PostgreSQL';
-  if (content.includes('UseSqlite')) return 'SQLite';
-  if (content.includes('UseCosmos')) return 'Cosmos DB';
-  return null;
-}
-
-/**
- * Detect hosting platform
- */
-function detectHosting(content) {
-  if (content.includes('Azure') || content.includes('AddAzure')) return 'Azure';
-  if (content.includes('AWS')) return 'AWS';
-  return null;
-}
-
-/**
- * Extract NuGet packages from .csproj
- */
-function extractNuGetPackages(csprojContent) {
-  const packages = [];
-  const regex = /<PackageReference\s+Include="([^"]+)"/g;
-  let match;
-
-  while ((match = regex.exec(csprojContent)) !== null) {
-    packages.push(match[1]);
-  }
-
-  return packages;
-}
+/**
+ * Config Detector - Reads configuration files to extract technologies, versions, and dependencies
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { glob } from 'glob';
+
+/**
+ * Detect project configuration
+ * @param {string} projectPath - Project root path
+ * @returns {Promise<Object>} Configuration detection results
+ */
+export async function detectConfig(projectPath) {
+  const result = {
+    language: 'unknown',
+    version: null,
+    packageManager: 'unknown',
+    dependencies: [],
+    technologies: [],
+    auth: null,
+    database: null,
+    hosting: null
+  };
+
+  // Detect .NET projects
+  const dotnetConfig = await detectDotNet(projectPath);
+  if (dotnetConfig) {
+    Object.assign(result, dotnetConfig);
+    return result;
+  }
+
+  // Detect Node.js projects
+  const nodeConfig = await detectNode(projectPath);
+  if (nodeConfig) {
+    Object.assign(result, nodeConfig);
+    return result;
+  }
+
+  return result;
+}
+
+/**
+ * Detect .NET configuration
+ */
+async function detectDotNet(projectPath) {
+  const programCs = join(projectPath, 'Program.cs');
+  const csprojFiles = await glob('**/*.csproj', { cwd: projectPath });
+
+  if (!existsSync(programCs) && csprojFiles.length === 0) {
+    return null;
+  }
+
+  const config = {
+    language: 'csharp',
+    version: null,
+    packageManager: 'dotnet',
+    dependencies: [],
+    technologies: [],
+    auth: null,
+    database: null,
+    hosting: null
+  };
+
+  // Read Program.cs
+  if (existsSync(programCs)) {
+    const content = readFileSync(programCs, 'utf8');
+
+    // Detect .NET version
+    if (content.includes('WebApplication.CreateBuilder') || content.includes('.NET')) {
+      config.version = detectDotNetVersion(content);
+    }
+
+    // Detect technologies from Program.cs
+    config.technologies = detectTechnologiesFromProgramCs(content);
+    config.auth = detectAuthMethod(content);
+    config.database = detectDatabase(content);
+    config.hosting = detectHosting(content);
+  }
+
+  // Read .csproj files
+  for (const csprojFile of csprojFiles.slice(0, 3)) { // Read first 3 csproj files
+    const csprojPath = join(projectPath, csprojFile);
+    const content = readFileSync(csprojPath, 'utf8');
+
+    config.dependencies.push(...extractNuGetPackages(content));
+  }
+
+  // Remove duplicates
+  config.dependencies = [...new Set(config.dependencies)];
+  config.technologies = [...new Set(config.technologies)];
+
+  return config;
+}
+
+/**
+ * Detect Node.js configuration
+ */
+async function detectNode(projectPath) {
+  const packageJsonPath = join(projectPath, 'package.json');
+
+  if (!existsSync(packageJsonPath)) {
+    return null;
+  }
+
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+
+  const config = {
+    language: 'javascript',
+    version: packageJson.engines?.node || null,
+    packageManager: existsSync(join(projectPath, 'yarn.lock')) ? 'yarn' :
+                    existsSync(join(projectPath, 'pnpm-lock.yaml')) ? 'pnpm' : 'npm',
+    dependencies: [],
+    technologies: [],
+    auth: null,
+    database: null,
+    hosting: null
+  };
+
+  // Extract dependencies
+  const allDeps = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies
+  };
+
+  config.dependencies = Object.keys(allDeps);
+
+  // Detect technologies
+  if (allDeps['next']) config.technologies.push('Next.js');
+  if (allDeps['react']) config.technologies.push('React');
+  if (allDeps['@clerk/nextjs']) config.auth = 'Clerk';
+  if (allDeps['prisma']) config.database = 'Prisma';
+
+  return config;
+}
+
+/**
+ * Detect .NET version from Program.cs
+ */
+function detectDotNetVersion(content) {
+  if (content.includes('.NET 10') || content.includes('net10.0')) return '.NET 10';
+  if (content.includes('.NET 9') || content.includes('net9.0')) return '.NET 9';
+  if (content.includes('.NET 8') || content.includes('net8.0')) return '.NET 8';
+  return 'unknown';
+}
+
+/**
+ * Detect technologies from Program.cs
+ */
+function detectTechnologiesFromProgramCs(content) {
+  const techs = [];
+
+  if (content.includes('AddBlazor') || content.includes('MapBlazorHub')) {
+    techs.push('Blazor Server');
+  }
+
+  if (content.includes('AddHangfire')) {
+    techs.push('Hangfire');
+  }
+
+  if (content.includes('IChatClient') || content.includes('Microsoft.Agents')) {
+    techs.push('Microsoft Agent Framework');
+  }
+
+  if (content.includes('AddDbContext') || content.includes('UseSqlServer')) {
+    techs.push('Entity Framework Core');
+  }
+
+  if (content.includes('AddFluentUIComponents') || content.includes('FluentUI')) {
+    techs.push('Fluent UI Blazor');
+  }
+
+  if (content.includes('AddMudServices') || content.includes('MudBlazor')) {
+    techs.push('MudBlazor');
+  }
+
+  return techs;
+}
+
+/**
+ * Detect authentication method
+ */
+function detectAuthMethod(content) {
+  if (content.includes('AddClerk') || content.includes('Clerk')) return 'Clerk';
+  if (content.includes('AddMicrosoftIdentity') || content.includes('Entra')) return 'Microsoft Entra';
+  if (content.includes('AddAuthentication')) return 'ASP.NET Identity';
+  return null;
+}
+
+/**
+ * Detect database
+ */
+function detectDatabase(content) {
+  if (content.includes('UseSqlServer')) return 'SQL Server';
+  if (content.includes('UsePostgres')) return 'PostgreSQL';
+  if (content.includes('UseSqlite')) return 'SQLite';
+  if (content.includes('UseCosmos')) return 'Cosmos DB';
+  return null;
+}
+
+/**
+ * Detect hosting platform
+ */
+function detectHosting(content) {
+  if (content.includes('Azure') || content.includes('AddAzure')) return 'Azure';
+  if (content.includes('AWS')) return 'AWS';
+  return null;
+}
+
+/**
+ * Extract NuGet packages from .csproj
+ */
+function extractNuGetPackages(csprojContent) {
+  const packages = [];
+  const regex = /<PackageReference\s+Include="([^"]+)"/g;
+  let match;
+
+  while ((match = regex.exec(csprojContent)) !== null) {
+    packages.push(match[1]);
+  }
+
+  return packages;
+}