npm-run-mcp-server 0.2.6 → 0.2.8

package/README.md

@@ -51,6 +51,7 @@ Add this server to your MCP host configuration. It uses stdio and automatically
 - **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
+- **Auto-Restart on Changes**: Automatically restarts when `package.json` scripts are modified, ensuring tools are always up-to-date
 
 ### As a CLI Tool
 
@@ -116,6 +117,16 @@ The MCP server is designed to work seamlessly across multiple projects without c
 
 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.
 
+### Auto-Restart on Script Changes
+
+The MCP server automatically monitors your `package.json` file for changes. When you add, remove, or modify scripts, the server will:
+
+1. **Detect the change** and log it (with `--verbose` flag)
+2. **Gracefully exit** to allow the MCP client to restart the server
+3. **Reload with new tools** based on the updated scripts
+
+This ensures your MCP tools are always synchronized with your current `package.json` scripts without manual intervention.
+
 ### Install in Claude Code (VS Code extension)
 
 Add to VS Code user/workspace settings (`settings.json`):

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, watch } from 'fs';
 import { promises as fsp } from 'fs';
 import { dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
@@ -160,7 +160,7 @@ async function main() {
     }
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
-    const selfPkgPath = resolve(__dirname, '..', 'package.json');
+    const selfPkgPath = resolve(__dirname, 'package.json');
     let serverName = 'npm-run-mcp-server';
     let serverVersion = '0.0.0';
     try {
@@ -170,9 +170,21 @@ async function main() {
                 serverName = selfPkg.name;
             if (selfPkg.version)
                 serverVersion = selfPkg.version;
+            if (verbose) {
+                console.error(`[mcp] loaded server info: ${serverName}@${serverVersion}`);
+            }
+        }
+        else {
+            if (verbose) {
+                console.error(`[mcp] package.json not found at: ${selfPkgPath}`);
+            }
+        }
+    }
+    catch (error) {
+        if (verbose) {
+            console.error(`[mcp] error reading package.json:`, error);
         }
     }
-    catch { }
     const server = new McpServer({ name: serverName, version: serverVersion });
     // Handle case where no package.json was found
     if (!projectDir || !projectPkg) {
@@ -267,6 +279,30 @@ async function main() {
     if (verbose) {
         console.error(`[mcp] stdio transport connected (waiting for initialize)`);
     }
+    // Set up file watcher for package.json changes
+    if (pkgJsonPath) {
+        if (verbose) {
+            console.error(`[mcp] setting up file watcher for: ${pkgJsonPath}`);
+        }
+        const watcher = watch(pkgJsonPath, (eventType) => {
+            if (eventType === 'change') {
+                if (verbose) {
+                    console.error(`[mcp] package.json changed, restarting server...`);
+                }
+                // Gracefully exit to allow the MCP client to restart the server
+                process.exit(0);
+            }
+        });
+        // Handle cleanup on process exit
+        process.on('SIGINT', () => {
+            watcher.close();
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            watcher.close();
+            process.exit(0);
+        });
+    }
 }
 // Run
 main().catch((err) => {

package/package.json

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