npm-run-mcp-server 0.2.2 → 0.2.4

package/README.md

@@ -43,9 +43,14 @@ npx npm-run-mcp-server
 
 ### As an MCP Server
 
-Add this server to your MCP host configuration. It uses stdio and dynamically exposes each script from the closest `package.json` (walking up from `process.cwd()`).
+Add this server to your MCP host configuration. It uses stdio and automatically detects your project's `package.json` using workspace environment variables or by walking up from the current working directory.
 
-The tool names match your script names. Each tool accepts an optional `args` string that is appended after `--` when running the script. The server detects your package manager (npm, pnpm, yarn, bun).
+**Key Features:**
+- **Automatic Workspace Detection**: Works seamlessly across different projects without configuration changes
+- **Smart Tool Names**: Script names with colons (like `install:discord`) are automatically converted to valid tool names (`install_discord`)
+- **Rich Descriptions**: Each tool includes the actual script command in its description
+- **Package Manager Detection**: Automatically detects npm, pnpm, yarn, or bun
+- **Optional Arguments**: Each tool accepts an optional `args` string that is appended after `--` when running the script
 
 ### As a CLI Tool
 
@@ -95,7 +100,7 @@ Option B — user settings (`settings.json`):
 }
 ```
 
-**Note**: The server automatically detects the current project's `package.json` using `process.cwd()`, so no hardcoded paths are needed. It works seamlessly across all your projects.
+**Note**: The server automatically detects the current project's `package.json` using workspace environment variables (like `WORKSPACE_FOLDER_PATHS`) or by walking up from the current working directory. No hardcoded paths are needed - it works seamlessly across all your projects.
 
 Then open Copilot Chat, switch to Agent mode, and start the `npm-scripts` server from the tools panel.
 
@@ -103,12 +108,13 @@ Then open Copilot Chat, switch to Agent mode, and start the `npm-scripts` server
 
 The MCP server is designed to work seamlessly across multiple projects without configuration changes:
 
-- **VS Code/Cursor**: Use workspace settings (`.vscode/mcp.json` or `.vscode/settings.json`) - the server automatically targets the current project
+- **VS Code/Cursor**: The server automatically detects the current workspace using environment variables like `WORKSPACE_FOLDER_PATHS`
 - **Claude Desktop**: The server uses the working directory where Claude is launched
 - **No Hardcoded Paths**: All examples use `npx npm-run-mcp-server` without `--cwd` flags
-- **Automatic Detection**: The server walks up the directory tree to find the nearest `package.json`
+- **Smart Detection**: The server first tries workspace environment variables, then falls back to walking up the directory tree to find the nearest `package.json`
+- **Cross-Platform**: Handles Windows/WSL path conversions automatically
 
-This means you can use the same MCP configuration across all your projects, and the server will automatically target the correct project based on where your MCP client is running.
+This means you can use the same MCP configuration across all your projects, and the server will automatically target the correct project based on your current workspace.
 
 ### Install in Claude Code (VS Code extension)
 

package/dist/index.js

@@ -85,7 +85,55 @@ function trimOutput(out, limit = 12000) {
 }
 async function main() {
     const args = parseCliArgs(process.argv);
-    const startCwd = args.cwd ? resolve(String(args.cwd)) : process.cwd();
+    // Try to detect workspace directory from environment variables
+    let startCwd = process.cwd(); // Initialize with fallback
+    if (args.cwd) {
+        startCwd = resolve(String(args.cwd));
+    }
+    else if (process.env.WORKSPACE_FOLDER_PATHS) {
+        // Cursor sets this as a semicolon-separated list, take the first one
+        const workspacePaths = process.env.WORKSPACE_FOLDER_PATHS.split(';');
+        let workspacePath = workspacePaths[0];
+        // Convert Windows path to WSL path if running in WSL
+        if (process.platform === 'linux' && workspacePath.match(/^[A-Za-z]:\\/)) {
+            // Convert H:\path\to\project to /mnt/h/path/to/project
+            const drive = workspacePath[0].toLowerCase();
+            const path = workspacePath.slice(3).replace(/\\/g, '/');
+            workspacePath = `/mnt/${drive}${path}`;
+        }
+        startCwd = workspacePath;
+    }
+    else if (process.env.VSCODE_WORKSPACE_FOLDER) {
+        startCwd = process.env.VSCODE_WORKSPACE_FOLDER;
+    }
+    else if (process.env.CURSOR_WORKSPACE_FOLDER) {
+        startCwd = process.env.CURSOR_WORKSPACE_FOLDER;
+    }
+    else {
+        // Fallback: try to find a workspace by looking for common patterns
+        const currentDir = process.cwd();
+        // If we're in the MCP server directory, try to find a parent directory with package.json
+        if (currentDir.includes('npm-run-mcp-server')) {
+            // Try going up directories to find a workspace
+            let testDir = dirname(currentDir);
+            let foundWorkspace = false;
+            for (let i = 0; i < 5; i++) {
+                const testPkgJson = resolve(testDir, 'package.json');
+                if (existsSync(testPkgJson)) {
+                    startCwd = testDir;
+                    foundWorkspace = true;
+                    break;
+                }
+                testDir = dirname(testDir);
+            }
+            if (!foundWorkspace) {
+                startCwd = currentDir;
+            }
+        }
+        else {
+            startCwd = currentDir;
+        }
+    }
     const pkgJsonPath = await findNearestPackageJson(startCwd);
     let projectDir = null;
     let projectPkg = null;
@@ -102,6 +150,7 @@ async function main() {
         (process.env.DEBUG && process.env.DEBUG.toLowerCase().includes('mcp')));
     if (verbose) {
         console.error(`[mcp] server starting: cwd=${startCwd}`);
+        console.error(`[mcp] detected workspace: ${process.env.VSCODE_WORKSPACE_FOLDER || process.env.CURSOR_WORKSPACE_FOLDER || 'none'}`);
         if (pkgJsonPath) {
             console.error(`[mcp] using package.json: ${pkgJsonPath}`);
         }
@@ -162,12 +211,9 @@ async function main() {
         const toolName = scriptName.toLowerCase().replace(/[^a-z0-9_-]/g, '_');
         // Create a more descriptive description
         const scriptCommand = scripts[scriptName];
-        const description = `Run npm script ${scriptName} - ${scriptCommand}`;
-        if (verbose) {
-            console.error(`[mcp] registering tool: ${toolName} with description: ${description}`);
-        }
+        const description = `Run script ${scriptName}`;
         server.tool(toolName, {
-            description,
+            description: description,
             inputSchema: {
                 type: 'object',
                 properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "npm-run-mcp-server",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "An MCP server that exposes package.json scripts as tools for agents.",
   "bin": {
     "npm-run-mcp-server": "dist/index.js"