@vespermcp/mcp-server 1.0.6 → 1.1.0

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

@@ -24,20 +24,6 @@ export class ConfigManager {
                     : 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"),
@@ -45,26 +31,16 @@ export class ConfigManager {
             },
             "vscode-copilot": {
                 name: "VS Code (Copilot)",
-                path: path.join(home, ".copilot", "mcp-config.json"),
+                path: isWin
+                    ? path.join(appData, "Code", "User", "globalStorage", "github.copilot-chat", "mcp.json")
+                    : path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "github.copilot-chat", "mcp.json"),
                 key: "mcpServers"
             },
             "vscode-global": {
                 name: "VS Code (Standard MCP)",
                 path: isWin
-                    ? path.join(appData, "Code", "User", "mcp.json")
-                    : path.join(home, "Library", "Application Support", "Code", "User", "mcp.json"),
-                key: "mcpServers"
-            },
-            "vscode-project": {
-                name: "VS Code (Project-specific)",
-                path: path.join(process.cwd(), ".vscode", "mcp.json"),
-                key: "mcpServers"
-            },
-            "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"),
+                    ? path.join(appData, "Code", "User", "globalStorage", "mcp-servers", "mcp.json")
+                    : path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "mcp-servers", "mcp.json"),
                 key: "mcpServers"
             },
             "vscode-settings": {
@@ -73,11 +49,6 @@ export class ConfigManager {
                     ? path.join(appData, "Code", "User", "settings.json")
                     : path.join(home, "Library", "Application Support", "Code", "User", "settings.json"),
                 key: "github.copilot.chat.mcp.servers"
-            },
-            "vscode-root": {
-                name: "VS Code (Workspace Root)",
-                path: path.join(process.cwd(), "mcp.json"),
-                key: "mcpServers"
             }
         };
     }
@@ -89,45 +60,23 @@ export class ConfigManager {
         const home = this.getHomeDir();
         for (const [key, cp] of Object.entries(paths)) {
             const isClaude = key === "claude-desktop";
-            const isCursor = key === "cursor";
+            const isCursor = key === "cursor" || key === "cursor-project";
             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"));
-            const hasCursorFolder = fs.existsSync(path.join(appData, "Cursor")) || fs.existsSync(path.join(home, ".cursor"));
-            const hasCodeFolder = fs.existsSync(path.join(appData, "Code")) || fs.existsSync(path.join(home, ".vscode"));
-            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"})`);
-                if (isClaude)
-                    console.log(`  - Claude Folder: ${path.join(appData, "Claude")} (${hasClaudeFolder ? "EXISTS" : "MISSING"})`);
-                if (isCursor)
-                    console.log(`  - Cursor Folder: ${path.join(appData, "Cursor")} (${hasCursorFolder ? "EXISTS" : "MISSING"})`);
-                if (isVSCode)
-                    console.log(`  - Code Folder: ${path.join(appData, "Code")} (${hasCodeFolder ? "EXISTS" : "MISSING"})`);
-                if (isCopilot)
-                    console.log(`  - Copilot Folder: ${path.join(this.getHomeDir(), ".copilot")} (${hasCopilotFolder ? "EXISTS" : "MISSING"})`);
-            }
-            const isCurrentIDE = (isCursor && (termProgram.includes("cursor") || (termProgram === "vscode" && hasCursorFolder))) ||
+            const isMac = process.platform === "darwin";
+            const hasClaudeFolder = fs.existsSync(path.join(appData, "Claude")) || (isMac && fs.existsSync(path.join(home, "Library", "Application Support", "Claude")));
+            const hasCursorFolder = fs.existsSync(path.join(appData, "Cursor")) || fs.existsSync(path.join(home, ".cursor")) || (isMac && fs.existsSync(path.join(home, "Library", "Application Support", "Cursor")));
+            const hasCodeFolder = fs.existsSync(path.join(appData, "Code")) || fs.existsSync(path.join(home, ".vscode")) || (isMac && fs.existsSync(path.join(home, "Library", "Application Support", "Code")));
+            const hasCopilotFolder = hasCodeFolder || fs.existsSync(path.join(home, ".copilot"));
+            const isCurrentIDE = (isCursor && termProgram.includes("cursor")) ||
                 (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) ||
+                (isVSCode && termProgram === "vscode" && hasCodeFolder);
+            // Detection logic
+            if ((isClaude && hasClaudeFolder) ||
                 (isCursor && hasCursorFolder) ||
                 (isVSCode && hasCodeFolder) ||
-                (key === "vscode-insiders" && hasInsidersFolder) ||
-                (isCopilot && hasCopilotFolder) ||
-                (isStandard && hasCodeFolder) ||
-                (isSettings && hasCodeFolder) ||
-                (isRoot && fs.existsSync(process.cwd()));
-            if (shouldDetectByFolder || fs.existsSync(cp.path) || isCurrentIDE || key === "cursor-project" || key === "vscode-project" || key === "vscode-root") {
+                isCurrentIDE ||
+                fs.existsSync(cp.path)) {
                 let displayName = cp.name;
                 if (isCurrentIDE) {
                     displayName += " (Current Terminal)";
@@ -137,6 +86,28 @@ export class ConfigManager {
         }
         return detected.filter((v, i, a) => a.findIndex(t => t.path === v.path) === i);
     }
+    getVesperExecutableConfig() {
+        const isWin = process.platform === "win32";
+        // Try to find absolute paths for maximum reliability in VS Code/Copilot
+        try {
+            const nodeExe = process.execPath;
+            // index.js is in build/index.js relative to ConfigManager in build/config/config-manager.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"]
+        };
+    }
     async installTo(configPath) {
         try {
             console.log(`[Vesper Setup] Installing to ${configPath.name} at ${configPath.path}...`);
@@ -165,21 +136,26 @@ export class ConfigManager {
             }
             const lastKey = keys[keys.length - 1];
             const mcpServers = current[lastKey] || {};
-            // Use the portable npx command as requested
-            // We use both 'vesper' (clean) and 'vespermcp' (legacy/alias) for compatibility
-            const isWin = process.platform === "win32";
+            // Use the most robust command format available (absolute paths if running from npx/installed)
+            const vesperExec = this.getVesperExecutableConfig();
             const serverConfig = {
-                command: isWin ? "npx.cmd" : "npx",
-                args: ["-y", "@vespermcp/mcp-server@latest"],
+                command: vesperExec.command,
+                args: vesperExec.args,
                 env: {
                     "HF_TOKEN": "YOUR_HUGGINGFACE_TOKEN_HERE",
-                    // Empty by default to avoid clutter, user can add if needed
                 }
             };
             mcpServers["vesper"] = serverConfig;
             // Also add alias for easy upgrading
             mcpServers["@vespermcp/mcp-server"] = serverConfig;
             current[lastKey] = mcpServers;
+            // If we are writing to settings.json or a copilot-specific file, sync to native mcp.servers key too
+            if (configPath.key.includes("copilot") || configPath.path.includes("settings.json")) {
+                if (!config["mcp.servers"])
+                    config["mcp.servers"] = {};
+                config["mcp.servers"]["vesper"] = serverConfig;
+                config["mcp.servers"]["@vespermcp/mcp-server"] = serverConfig;
+            }
             const content = JSON.stringify(config, null, 2);
             if (process.env.VESPER_DEBUG) {
                 console.log(`[Vesper Setup] Writing to ${configPath.path}:`);

package/build/index.js

@@ -25,13 +25,15 @@ 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);
 const __dirname = path.dirname(__filename);
 // appRoot: Where the source code/scripts are (inside node_modules or source)
 const appRoot = path.join(__dirname, "..");
-// dataRoot: Where database and user data live (in user home) to prevent data loss on update and running from node_modules
-const homeDir = process.env.HOME || process.env.USERPROFILE || appRoot;
+// dataRoot: Where database and user data live (in user home)
+// Use os.homedir() as it's more reliable than env vars
+const homeDir = os.homedir() || process.env.HOME || process.env.USERPROFILE || appRoot;
 const dataRoot = path.join(homeDir, ".vesper");
 // Ensure data directory exists
 if (!fs.existsSync(dataRoot))
@@ -39,6 +41,8 @@ if (!fs.existsSync(dataRoot))
 const dbPath = path.join(dataRoot, "data", "metadata.db");
 const vectorPath = path.join(dataRoot, "data", "vectors.json");
 const errorLogPath = path.join(dataRoot, "vesper_errors.log");
+console.error(`[Vesper] Data directory: ${dataRoot}`);
+console.error(`[Vesper] Database path: ${dbPath}`);
 function logError(err, context) {
     const timestamp = new Date().toISOString();
     const stack = err.stack || String(err);

package/package.json

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