@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/discovery/mcp-scanner.js

@@ -0,0 +1,218 @@
+/**
+ * mcp-scanner.ts
+ *
+ * MCP server auto-discovery: scans common locations for MCP server definitions
+ * that are not already registered in the active config.
+ *
+ * Scan locations (in order):
+ *   1. Project .mcp/ directory — looks for mcp.json or index.js/index.ts scripts
+ *   2. ~/.goodvibes/sdk/mcp/ — user-global MCP server definitions
+ *   3. Locally installed npx MCP packages (node_modules/.bin/@modelcontextprotocol/*)
+ *
+ * Returns suggested McpServerConfig[] for servers not already in the registry.
+ */
+import { existsSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+/**
+ * Well-known npx-installable MCP server package names.
+ * These are the official @modelcontextprotocol packages.
+ */
+const KNOWN_NPX_MCP_PACKAGES = [
+    '@modelcontextprotocol/server-filesystem',
+    '@modelcontextprotocol/server-github',
+    '@modelcontextprotocol/server-gitlab',
+    '@modelcontextprotocol/server-google-drive',
+    '@modelcontextprotocol/server-google-maps',
+    '@modelcontextprotocol/server-memory',
+    '@modelcontextprotocol/server-postgres',
+    '@modelcontextprotocol/server-puppeteer',
+    '@modelcontextprotocol/server-sequential-thinking',
+    '@modelcontextprotocol/server-slack',
+    '@modelcontextprotocol/server-sqlite',
+    '@modelcontextprotocol/server-brave-search',
+    '@modelcontextprotocol/server-fetch',
+    '@modelcontextprotocol/server-everything',
+];
+/**
+ * Parse a server name from a package name or directory name.
+ * e.g. '@modelcontextprotocol/server-filesystem' → 'filesystem'
+ *      'my-mcp-server' → 'my-mcp-server'
+ */
+function deriveServerName(nameOrPath) {
+    // Strip scope prefix and 'server-' prefix for known MCP packages
+    const stripped = nameOrPath.replace(/^@[^/]+\/server-/, '').replace(/^server-/, '');
+    return stripped || nameOrPath;
+}
+/**
+ * Check if a given package is installed locally (in node_modules).
+ * Returns the bin path if found, null otherwise.
+ */
+function findLocalNpxBin(cwd, packageName) {
+    // Check project-local node_modules/.bin
+    const binName = packageName.replace(/^@[^/]+\//, '');
+    const localBin = join(cwd, 'node_modules', '.bin', binName);
+    if (existsSync(localBin))
+        return localBin;
+    // Also check if the package itself exists in node_modules
+    const localPkg = join(cwd, 'node_modules', packageName, 'package.json');
+    if (existsSync(localPkg))
+        return packageName;
+    return null;
+}
+/**
+ * Scan the project .mcp/ directory for server entry points.
+ * Looks for:
+ *   - .mcp/mcp.json (already handled by loadMcpConfig, skip)
+ *   - .mcp/<name>/index.js or .mcp/<name>/index.ts or .mcp/<name>/server.js
+ */
+function scanProjectMcpDir(roots, knownNames) {
+    const mcpDir = join(roots.workingDirectory, '.mcp');
+    if (!existsSync(mcpDir))
+        return [];
+    const suggestions = [];
+    try {
+        const entries = readdirSync(mcpDir);
+        for (const entry of entries) {
+            // Skip mcp.json — already read by loadMcpConfig
+            if (entry === 'mcp.json')
+                continue;
+            const entryPath = join(mcpDir, entry);
+            try {
+                const stat = statSync(entryPath);
+                if (!stat.isDirectory())
+                    continue;
+                // Look for a server entry point inside the subdirectory
+                const candidates = ['index.js', 'index.ts', 'server.js', 'server.ts', 'main.js', 'main.ts'];
+                for (const candidate of candidates) {
+                    const candidatePath = join(entryPath, candidate);
+                    if (existsSync(candidatePath)) {
+                        if (knownNames.has(entry))
+                            break; // already registered
+                        const runtime = candidate.endsWith('.ts') ? 'bun' : 'node';
+                        suggestions.push({
+                            name: entry,
+                            command: runtime,
+                            args: [candidatePath],
+                        });
+                        break;
+                    }
+                }
+            }
+            catch {
+                // Skip unreadable entries
+            }
+        }
+    }
+    catch (err) {
+        logger.debug('[mcp-scanner] Failed to read project .mcp/ directory', { error: summarizeError(err) });
+    }
+    return suggestions;
+}
+/**
+ * Scan ~/.goodvibes/sdk/mcp/ for user-global server scripts.
+ * Looks for:
+ *   - <name>/index.js, <name>/server.js, etc.
+ *   - <name>.js, <name>.ts standalone scripts
+ */
+function scanGoodvibesMcpDir(roots, knownNames) {
+    const mcpDir = join(roots.homeDirectory, '.goodvibes', 'sdk', 'mcp');
+    if (!existsSync(mcpDir))
+        return [];
+    const suggestions = [];
+    try {
+        const entries = readdirSync(mcpDir);
+        for (const entry of entries) {
+            const entryPath = join(mcpDir, entry);
+            try {
+                const stat = statSync(entryPath);
+                if (stat.isDirectory()) {
+                    const candidates = ['index.js', 'index.ts', 'server.js', 'server.ts'];
+                    for (const candidate of candidates) {
+                        const candidatePath = join(entryPath, candidate);
+                        if (existsSync(candidatePath)) {
+                            if (knownNames.has(entry))
+                                break;
+                            const runtime = candidate.endsWith('.ts') ? 'bun' : 'node';
+                            suggestions.push({ name: entry, command: runtime, args: [candidatePath] });
+                            break;
+                        }
+                    }
+                }
+                else if (stat.isFile()) {
+                    // Standalone script: name.js or name.ts
+                    if (!entry.endsWith('.js') && !entry.endsWith('.ts'))
+                        continue;
+                    const baseName = entry.replace(/\.(js|ts)$/, '');
+                    if (knownNames.has(baseName))
+                        continue;
+                    const runtime = entry.endsWith('.ts') ? 'bun' : 'node';
+                    suggestions.push({ name: baseName, command: runtime, args: [entryPath] });
+                }
+            }
+            catch {
+                // Skip unreadable entries
+            }
+        }
+    }
+    catch (err) {
+        logger.debug('[mcp-scanner] Failed to read ~/.goodvibes/sdk/mcp/', { error: summarizeError(err) });
+    }
+    return suggestions;
+}
+/**
+ * Check for locally-installed npx MCP packages not already registered.
+ */
+function scanNpxMcpPackages(roots, knownNames) {
+    const suggestions = [];
+    for (const pkg of KNOWN_NPX_MCP_PACKAGES) {
+        const binPath = findLocalNpxBin(roots.workingDirectory, pkg);
+        if (!binPath)
+            continue;
+        const serverName = deriveServerName(pkg);
+        if (knownNames.has(serverName))
+            continue;
+        suggestions.push({
+            name: serverName,
+            command: 'npx',
+            args: ['-y', pkg],
+        });
+    }
+    return suggestions;
+}
+/**
+ * Scan all common MCP server locations and return suggestions for
+ * servers not already registered in the given set of known server names.
+ *
+ * @param roots - Explicit working/home roots for project and user MCP discovery
+ * @param registeredNames - Set of already-registered server names to skip
+ */
+export async function scanMcpServers(roots, registeredNames = new Set()) {
+    let locationsScanned = 0;
+    const suggestions = [];
+    const seen = new Set(registeredNames);
+    // Helper to add suggestions without duplicating names
+    const addSuggestions = (found) => {
+        for (const s of found) {
+            if (!seen.has(s.name)) {
+                seen.add(s.name);
+                suggestions.push(s);
+            }
+        }
+    };
+    // 1. Project .mcp/ directory
+    locationsScanned++;
+    addSuggestions(scanProjectMcpDir(roots, registeredNames));
+    // 2. ~/.goodvibes/sdk/mcp/ user-global directory
+    locationsScanned++;
+    addSuggestions(scanGoodvibesMcpDir(roots, registeredNames));
+    // 3. Locally installed npx MCP packages
+    locationsScanned++;
+    addSuggestions(scanNpxMcpPackages(roots, registeredNames));
+    logger.debug('[mcp-scanner] Scan complete', {
+        locationsScanned,
+        suggestions: suggestions.length,
+    });
+    return { suggestions, locationsScanned };
+}

package/dist/_internal/platform/discovery/scanner.d.ts

@@ -0,0 +1,49 @@
+import type { ShellPathService } from '../runtime/shell-paths.js';
+export type ServerType = 'ollama' | 'lm-studio' | 'vllm' | 'llamacpp' | 'localai' | 'tgi' | 'jan' | 'gpt4all' | 'koboldcpp' | 'aphrodite' | 'unknown';
+export interface DiscoveredServer {
+    name: string;
+    host: string;
+    port: number;
+    baseURL: string;
+    models: string[];
+    serverType: ServerType;
+    modelContextWindows?: Record<string, number>;
+    modelOutputLimits?: Record<string, number>;
+}
+export interface ScanResult {
+    servers: DiscoveredServer[];
+    scannedHosts: number;
+    scannedPorts: number;
+    durationMs: number;
+}
+type DiscoveryRoots = Pick<ShellPathService, 'homeDirectory'>;
+/** Load previously discovered providers from disk. Returns empty array if file doesn't exist. */
+export declare function loadPersistedProviders(roots: DiscoveryRoots): DiscoveredServer[];
+/** Save discovered providers to disk. Merges with existing entries keyed by host:port. */
+export declare function persistProviders(roots: DiscoveryRoots, servers: DiscoveredServer[]): void;
+/** Remove specific servers from the persisted file (by host:port). */
+export declare function removePersistedProviders(roots: DiscoveryRoots, toRemove: Array<{
+    host: string;
+    port: number;
+}>): void;
+/**
+ * Queries a discovered server for actual context window sizes of its models.
+ * Returns a map of modelId -> contextWindow. Missing entries mean the server
+ * didn't report a context length for that model.
+ */
+export declare function fetchModelContextWindows(host: string, port: number, serverType: ServerType, models: string[]): Promise<Record<string, number>>;
+/**
+ * Scans a list of hosts across all known ports.
+ */
+export declare function scanHosts(hosts: string[], onProgress?: (completed: number, total: number) => void): Promise<DiscoveredServer[]>;
+/**
+ * Scans only localhost (fast, ~100ms).
+ */
+export declare function scanLocalhost(): Promise<ScanResult>;
+/**
+ * Full scan: localhost first, then all /24 subnet IPs.
+ * Returns merged, deduplicated results.
+ */
+export declare function scan(onProgress?: (completed: number, total: number) => void): Promise<ScanResult>;
+export {};
+//# sourceMappingURL=scanner.d.ts.map

package/dist/_internal/platform/discovery/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/discovery/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEtJ,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,KAAK,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAU9D,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,EAAE,CAiBhF;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CA+BzF;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAcrH;AAoMD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0KjC;AA4MD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACtD,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkC7B;AAMD;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CASzD;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACtD,OAAO,CAAC,UAAU,CAAC,CA8BrB"}