@vespermcp/mcp-server 1.0.8 → 1.1.1

package/README.md

@@ -31,23 +31,23 @@ Vesper is a Model Context Protocol (MCP) server that helps you find, analyze, an
 
 ## 📦 Installation
 
-### Option A: Install via NPX (Easiest)
-Run the setup wizard to automatically configure Vesper for Cursor, Claude Desktop, and VS Code:
+## 🚀 Quick Start (VS Code + Copilot)
 
-```bash
-npx @vespermcp/mcp-server@latest --setup
-```
+The fastest way to install Vesper and configure it for **GitHub Copilot Chat** or **Cursor** is to run the automated setup:
 
-### Option B: Install Globally
 ```bash
-npm install -g @vespermcp/mcp-server
-vesper --setup
+npx -y @vespermcp/mcp-server@latest --setup
 ```
 
-The postinstall script will automatically:
-- Install Python dependencies (opencv-python, librosa, etc.)
-- Create data directories in `~/.vesper`
-- Display setup instructions
+1.  Select **Visual Studio Code (Settings.json)** from the list.
+2.  Restart VS Code.
+3.  Open Copilot Chat and look for the **MCP Servers** section.
+
+## 🛠️ Configuration
+Vesper supports:
+- **GitHub Copilot Chat**: Automated setup via `settings.json`.
+- **Cursor**: Automated setup via `mcp.json`.
+- **Claude Desktop**: Automated setup via `claude_desktop_config.json`.
 
 ### Manual Python Setup (if needed)
 

package/build/config/config-manager.js

@@ -5,211 +5,217 @@ export class ConfigManager {
     getHomeDir() {
         return os.homedir();
     }
-    getConfigPaths() {
+    /**
+     * All known coding agent configuration paths.
+     * Based on the `add-mcp` standard used by the MCP ecosystem.
+     */
+    getAllAgents() {
         const home = this.getHomeDir();
         const isWin = process.platform === "win32";
-        const appData = process.env.APPDATA || "";
-        return {
-            "claude-desktop": {
+        const isMac = process.platform === "darwin";
+        const appData = process.env.APPDATA || path.join(home, "AppData", "Roaming");
+        const agents = [
+            // Claude Code: ~/.claude.json
+            {
+                name: "Claude Code",
+                path: path.join(home, ".claude.json"),
+                format: "json-mcpServers",
+                serverType: "stdio",
+            },
+            // Claude Desktop: %APPDATA%/Claude/claude_desktop_config.json
+            {
                 name: "Claude Desktop",
                 path: isWin
                     ? path.join(appData, "Claude", "claude_desktop_config.json")
-                    : path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
-                key: "mcpServers"
+                    : isMac
+                        ? path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json")
+                        : path.join(home, ".config", "claude", "claude_desktop_config.json"),
+                format: "json-mcpServers",
+                serverType: "stdio",
             },
-            "cursor": {
+            // Cursor: ~/.cursor/mcp.json
+            {
                 name: "Cursor",
-                path: isWin
-                    ? path.join(appData, "Cursor", "User", "globalStorage", "rohit-gohri.cursor-mcp", "mcp.json")
-                    : path.join(home, "Library", "Application Support", "Cursor", "User", "globalStorage", "rohit-gohri.cursor-mcp", "mcp.json"),
-                key: "mcpServers"
-            },
-            "vscode-cline": {
-                name: "VS Code (Cline)",
-                path: isWin
-                    ? path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json")
-                    : path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
-                key: "mcpServers"
-            },
-            "vscode-roo-code": {
-                name: "VS Code (Roo Code)",
-                path: isWin
-                    ? path.join(appData, "Code", "User", "globalStorage", "RooVeterans.roo-cline", "settings", "cline_mcp_settings.json")
-                    : path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "RooVeterans.roo-cline", "settings", "cline_mcp_settings.json"),
-                key: "mcpServers"
-            },
-            "cursor-project": {
-                name: "Cursor (Project-specific)",
-                path: path.join(process.cwd(), ".cursor", "mcp.json"),
-                key: "mcpServers"
-            },
-            "vscode-copilot": {
-                name: "VS Code (Copilot)",
-                path: path.join(home, ".copilot", "mcp-config.json"),
-                key: "mcpServers"
+                path: path.join(home, ".cursor", "mcp.json"),
+                format: "json-mcpServers",
+                serverType: "stdio",
             },
-            "vscode-global": {
-                name: "VS Code (Standard MCP)",
+            // VS Code: %APPDATA%/Code/User/mcp.json (uses "servers" key, NOT "mcpServers")
+            {
+                name: "VS Code",
                 path: isWin
                     ? path.join(appData, "Code", "User", "mcp.json")
-                    : path.join(home, "Library", "Application Support", "Code", "User", "mcp.json"),
-                key: "mcpServers"
+                    : isMac
+                        ? path.join(home, "Library", "Application Support", "Code", "User", "mcp.json")
+                        : path.join(home, ".config", "Code", "User", "mcp.json"),
+                format: "json-servers",
+                serverType: "stdio",
             },
-            "vscode-project": {
-                name: "VS Code (Project-specific)",
-                path: path.join(process.cwd(), ".vscode", "mcp.json"),
-                key: "mcpServers"
+            // Codex: ~/.codex/config.toml
+            {
+                name: "Codex",
+                path: path.join(home, ".codex", "config.toml"),
+                format: "toml",
+                serverType: "stdio",
             },
-            "vscode-insiders": {
-                name: "VS Code Insiders",
-                path: isWin
-                    ? path.join(appData, "Code - Insiders", "User", "mcp.json")
-                    : path.join(home, "Library", "Application Support", "Code - Insiders", "User", "mcp.json"),
-                key: "mcpServers"
-            },
-            "vscode-settings": {
-                name: "VS Code (Settings.json)",
-                path: isWin
-                    ? path.join(appData, "Code", "User", "settings.json")
-                    : path.join(home, "Library", "Application Support", "Code", "User", "settings.json"),
-                key: "github.copilot.chat.mcp.servers"
+            // Antigravity / Gemini CLI: ~/.gemini/settings.json
+            {
+                name: "Antigravity",
+                path: path.join(home, ".gemini", "settings.json"),
+                format: "json-mcpServers",
+                serverType: "stdio",
             },
-            "vscode-root": {
-                name: "VS Code (Workspace Root)",
-                path: path.join(process.cwd(), "mcp.json"),
-                key: "mcpServers"
-            }
-        };
+        ];
+        return agents;
     }
+    /**
+     * Detect which agents are installed on this machine.
+     */
     detectIDEs() {
-        const paths = this.getConfigPaths();
+        const agents = this.getAllAgents();
         const detected = [];
-        const termProgram = (process.env.TERM_PROGRAM || "").toLowerCase();
-        const appData = process.env.APPDATA || "";
-        const home = this.getHomeDir();
-        for (const [key, cp] of Object.entries(paths)) {
-            const isClaude = key === "claude-desktop";
-            const isCursor = key === "cursor";
-            const isVSCode = key.startsWith("vscode");
-            const isCopilot = key === "vscode-copilot";
-            const isStandard = key === "vscode-global";
-            const isSettings = key === "vscode-settings";
-            const isRoot = key === "vscode-root";
-            const hasClaudeFolder = fs.existsSync(path.join(appData, "Claude")) || (process.platform === "darwin" && fs.existsSync(path.join(home, "Library", "Application Support", "Claude")));
-            const hasCursorFolder = fs.existsSync(path.join(appData, "Cursor")) || fs.existsSync(path.join(home, ".cursor")) || (process.platform === "darwin" && fs.existsSync(path.join(home, "Library", "Application Support", "Cursor")));
-            const hasCodeFolder = fs.existsSync(path.join(appData, "Code")) || fs.existsSync(path.join(home, ".vscode")) || (process.platform === "darwin" && fs.existsSync(path.join(home, "Library", "Application Support", "Code")));
-            const hasInsidersFolder = fs.existsSync(path.join(appData, "Code - Insiders"));
-            const hasCopilotFolder = fs.existsSync(path.join(home, ".copilot"));
-            if (process.env.VESPER_DEBUG) {
-                console.log(`[Debug] Checking ${key}:`);
-                console.log(`  - Config Path: ${cp.path} (${fs.existsSync(cp.path) ? "EXISTS" : "MISSING"})`);
-            }
-            const isCurrentIDE = (isCursor && (termProgram.includes("cursor") || (termProgram === "vscode" && hasCursorFolder))) ||
-                (isClaude && termProgram.includes("claude")) ||
-                (isVSCode && termProgram === "vscode" && (hasCodeFolder || hasInsidersFolder)) ||
-                (isCopilot && hasCopilotFolder) ||
-                (isStandard && termProgram === "vscode") ||
-                (isSettings && termProgram === "vscode");
-            // Also check if the config file actually exists OR the root folder exists
-            const shouldDetectByFolder = (isClaude && hasClaudeFolder) ||
-                (isCursor && hasCursorFolder) ||
-                (isVSCode && (hasCodeFolder || hasInsidersFolder)) ||
-                (isCopilot && hasCopilotFolder) ||
-                (isSettings && hasCodeFolder);
-            if (shouldDetectByFolder || fs.existsSync(cp.path) || isCurrentIDE || key === "cursor-project" || key === "vscode-project" || key === "vscode-root") {
-                let displayName = cp.name;
-                if (isCurrentIDE) {
-                    displayName += " (Current Terminal)";
-                }
-                detected.push({ ...cp, name: displayName });
+        for (const agent of agents) {
+            const configDir = path.dirname(agent.path);
+            const configExists = fs.existsSync(agent.path);
+            const dirExists = fs.existsSync(configDir);
+            if (configExists || dirExists) {
+                detected.push(agent);
             }
         }
-        return detected.filter((v, i, a) => a.findIndex(t => t.path === v.path) === i);
+        return detected;
     }
-    getVesperExecutableConfig() {
+    /**
+     * Build the server config object for Vesper.
+     */
+    getServerConfig() {
         const isWin = process.platform === "win32";
-        // Try to find absolute paths for maximum reliability in VS Code/Copilot
-        try {
-            const nodeExe = process.execPath;
-            // ConfigManager is in build/config/config-manager.js
-            // index.js is in build/index.js
-            const vesperScript = path.resolve(__dirname, "../../index.js");
-            if (fs.existsSync(vesperScript)) {
-                return {
-                    command: nodeExe,
-                    args: [vesperScript]
-                };
-            }
-        }
-        catch (e) {
-            // Fallback to npx
-        }
         return {
             command: isWin ? "npx.cmd" : "npx",
-            args: ["-y", "@vespermcp/mcp-server@latest"]
+            args: ["-y", "@vespermcp/mcp-server@latest"],
         };
     }
-    async installTo(configPath) {
+    /**
+     * Install Vesper to a single agent configuration.
+     */
+    async installTo(agent) {
         try {
-            console.log(`[Vesper Setup] Installing to ${configPath.name} at ${configPath.path}...`);
+            console.log(`[Vesper Setup] Installing to ${agent.name}...`);
+            if (agent.format === "toml") {
+                return this.installToToml(agent);
+            }
+            // JSON-based agents
             let config = {};
-            if (fs.existsSync(configPath.path)) {
+            if (fs.existsSync(agent.path)) {
                 try {
-                    const content = fs.readFileSync(configPath.path, "utf-8").trim();
+                    const content = fs.readFileSync(agent.path, "utf-8").trim();
                     config = content ? JSON.parse(content) : {};
                 }
                 catch (e) {
-                    console.warn(`[Vesper Setup] Could not parse ${configPath.path}, starting fresh`);
+                    console.warn(`[Vesper Setup] Could not parse ${agent.path}, starting fresh`);
                     config = {};
                 }
             }
             else {
-                console.log(`[Vesper Setup] Creating directory: ${path.dirname(configPath.path)}`);
-                fs.mkdirSync(path.dirname(configPath.path), { recursive: true });
-            }
-            // Handle nested keys (e.g., "github.copilot.chat.mcp.servers")
-            const keys = configPath.key.split('.');
-            let current = config;
-            for (let i = 0; i < keys.length - 1; i++) {
-                if (!current[keys[i]])
-                    current[keys[i]] = {};
-                current = current[keys[i]];
+                fs.mkdirSync(path.dirname(agent.path), { recursive: true });
             }
-            const lastKey = keys[keys.length - 1];
-            const mcpServers = current[lastKey] || {};
-            // Use the most robust command format available (absolute paths if running from npx/installed)
-            const vesperExec = this.getVesperExecutableConfig();
-            const serverConfig = {
-                command: vesperExec.command,
-                args: vesperExec.args,
-                env: {
-                    "HF_TOKEN": "YOUR_HUGGINGFACE_TOKEN_HERE",
-                }
+            const vesperConfig = this.getServerConfig();
+            const serverEntry = {
+                command: vesperConfig.command,
+                args: vesperConfig.args,
             };
-            mcpServers["vesper"] = serverConfig;
-            // Also add alias for easy upgrading
-            mcpServers["@vespermcp/mcp-server"] = serverConfig;
-            current[lastKey] = mcpServers;
-            // If we are writing to settings.json, also add "mcp.servers" for native VS Code MCP view
-            if (configPath.key.includes("copilot")) {
-                if (!config["mcp.servers"])
-                    config["mcp.servers"] = {};
-                config["mcp.servers"]["vesper"] = serverConfig;
+            // Determine the correct key based on agent format
+            if (agent.format === "json-servers") {
+                // VS Code native MCP format: { "servers": { "vesper": { "type": "stdio", "command": ..., "args": ... } } }
+                if (!config.servers)
+                    config.servers = {};
+                config.servers["vesper"] = {
+                    type: "stdio",
+                    ...serverEntry,
+                };
+                console.log(`  ✓ Added to "servers" key (VS Code native format)`);
             }
-            const content = JSON.stringify(config, null, 2);
-            if (process.env.VESPER_DEBUG) {
-                console.log(`[Vesper Setup] Writing to ${configPath.path}:`);
-                console.log(content);
+            else {
+                // Standard mcpServers format: { "mcpServers": { "vesper": { "command": ..., "args": ... } } }
+                if (!config.mcpServers)
+                    config.mcpServers = {};
+                config.mcpServers["vesper"] = serverEntry;
+                console.log(`  ✓ Added to "mcpServers" key`);
             }
-            fs.writeFileSync(configPath.path, content, "utf8");
-            // Verify write
-            const finalSize = fs.statSync(configPath.path).size;
-            console.log(`[Vesper Setup] Successfully wrote ${finalSize} bytes to ${configPath.name}`);
+            fs.writeFileSync(agent.path, JSON.stringify(config, null, 2), "utf8");
+            const size = fs.statSync(agent.path).size;
+            console.log(`  ✓ ${agent.name}: ${agent.path} (${size} bytes)`);
             return true;
         }
         catch (error) {
-            console.error(`Failed to install to ${configPath.name}:`, error);
+            console.error(`  ✗ Failed to install to ${agent.name}:`, error);
             return false;
         }
     }
+    /**
+     * Install to TOML-based agents (Codex).
+     */
+    installToToml(agent) {
+        try {
+            let content = "";
+            if (fs.existsSync(agent.path)) {
+                content = fs.readFileSync(agent.path, "utf-8");
+            }
+            else {
+                fs.mkdirSync(path.dirname(agent.path), { recursive: true });
+            }
+            // Check if vesper is already configured
+            if (content.includes("[mcp_servers.vesper]")) {
+                console.log(`  ✓ ${agent.name}: Already configured`);
+                return true;
+            }
+            const vesperConfig = this.getServerConfig();
+            const isWin = process.platform === "win32";
+            const tomlEntry = `
+[mcp_servers.vesper]
+command = "${vesperConfig.command}"
+args = [${vesperConfig.args.map(a => `"${a}"`).join(", ")}]
+`;
+            content += tomlEntry;
+            fs.writeFileSync(agent.path, content, "utf8");
+            console.log(`  ✓ ${agent.name}: ${agent.path}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`  ✗ Failed to install to ${agent.name}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Install Vesper to ALL detected agents automatically.
+     */
+    async installToAll() {
+        const agents = this.detectIDEs();
+        const success = [];
+        const failed = [];
+        console.log(`\n📦 Installing Vesper to ${agents.length} detected agents...\n`);
+        for (const agent of agents) {
+            const result = await this.installTo(agent);
+            if (result) {
+                success.push(agent.name);
+            }
+            else {
+                failed.push(agent.name);
+            }
+        }
+        console.log(`\n┌─────────────────────────────────────────────┐`);
+        console.log(`│  Installation Summary                       │`);
+        console.log(`├─────────────────────────────────────────────┤`);
+        if (success.length > 0) {
+            for (const name of success) {
+                console.log(`│  ✓ ${name.padEnd(40)}│`);
+            }
+        }
+        if (failed.length > 0) {
+            for (const name of failed) {
+                console.log(`│  ✗ ${name.padEnd(40)}│`);
+            }
+        }
+        console.log(`└─────────────────────────────────────────────┘\n`);
+        return { success, failed };
+    }
 }

package/build/index.js

@@ -24,7 +24,6 @@ import { ImageAnalyzer } from "./quality/image-analyzer.js";
 import { MediaAnalyzer } from "./quality/media-analyzer.js";
 import { QualityOrchestrator } from "./quality/quality-orchestrator.js";
 import { ConfigManager } from "./config/config-manager.js";
-import { Selector } from "./utils/selector.js";
 import os from "os";
 // Determine absolute paths relative to the compiled script
 const __filename = fileURLToPath(import.meta.url);
@@ -782,52 +781,21 @@ async function main() {
 async function runSetupWizard(silent = false) {
     const configManager = new ConfigManager();
     if (!silent) {
-        console.log(`\n🚀 Welcome to Vesper MCP Setup!`);
-        console.log(`--------------------------------`);
-        console.log(`Searching for IDE configurations...`);
+        console.log(`\n🚀 Vesper MCP - Universal Setup`);
+        console.log(`================================`);
+        console.log(`Installing to all detected coding agents...\n`);
     }
-    const ides = configManager.detectIDEs();
-    if (ides.length === 0) {
+    const result = await configManager.installToAll();
+    if (result.success.length === 0 && result.failed.length === 0) {
         if (!silent) {
-            console.log("\n❌ No supported IDEs detected.");
-            console.log("I checked for:");
-            console.log(" - Cursor (Global & Project)");
-            console.log(" - Claude Desktop");
-            console.log(" - VS Code (Standard MCP, Copilot Chat, Cline, Roo Code)");
-            console.log("\nIf you are using VS Code or Cursor, please make sure they are installed.");
-            console.log("For project-specific setup, run this command inside your project folder.");
+            console.log("\n❌ No supported agents detected.");
+            console.log("Supported agents: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Antigravity");
+            console.log("\nMake sure at least one is installed, then try again.");
         }
         return;
     }
-    if (silent) {
-        for (const ide of ides) {
-            await configManager.installTo(ide);
-        }
-        return;
-    }
-    console.log(`\nFound ${ides.length} potential application(s):`);
-    const selector = new Selector("Select applications to configure for Vesper:", ides.map(ide => ({
-        name: ide.name,
-        value: ide,
-        selected: true
-    })));
-    const selectedIDEs = await selector.run();
-    if (selectedIDEs.length > 0) {
-        console.log(`\nInstalling to ${selectedIDEs.length} application(s)...\n`);
-        for (const ide of selectedIDEs) {
-            process.stdout.write(`Installing to ${ide.name}... `);
-            const success = await configManager.installTo(ide);
-            if (success) {
-                process.stdout.write("✅\n");
-            }
-            else {
-                process.stdout.write("❌ (Check permissions or if file is in use)\n");
-            }
-        }
-        console.log("\n✨ Setup complete! Please RESTART your IDE(s) to apply changes.");
-    }
-    else {
-        console.log("\nSetup skipped. No applications selected.");
+    if (!silent) {
+        console.log("✨ Setup complete! Please RESTART your IDE(s) to apply changes.");
     }
 }
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vespermcp/mcp-server",
-  "version": "1.0.8",
+  "version": "1.1.1",
   "description": "AI-powered dataset discovery, quality analysis, and preparation MCP server with multimodal support (text, image, audio, video)",
   "type": "module",
   "main": "build/index.js",