Npm Run MCP server

npm-run-mcp-server

Give your AI Agent the power to build, test, and deploy your project using your existing package.json scripts.

npm-run-mcp-server is a Model Context Protocol (MCP) server that automatically bridges your project's npm scripts to your AI assistant.

• 🔍 Auto-detects your project's package.json (no hardcoded paths).
• 📦 Works with everything: npm, pnpm, yarn, and bun.
• 🔒 Safe & Configurable: Whitelist specific scripts to prevent accidental execution.
• ⚡ Zero-config: Works out of the box, but scales with detailed config.

⚡ Quick Start

Connect your agent to your scripts in seconds. No global installation required—just let npx handle it.

Claude Desktop

Add this to your claudedesktopconfig.json:

{
  "mcpServers": {
    "npm-scripts": {
      "command": "npx",
      "args": ["-y", "npm-run-mcp-server"]
    }
  }
}

Cursor

1. Go to Settings > Features > MCP Servers.
2. Click + Add New MCP Server.
3. Enter the details:

• Type: command
• Name: npm-scripts
• Command: npx
• Args: -y npm-run-mcp-server

VS Code (GitHub Copilot)

Add this to your workspace .vscode/settings.json:

{
  "github.copilot.chat.mcpServers": {
    "npm-scripts": {
      "command": "npx",
      "args": ["-y", "npm-run-mcp-server"]
    }
  }
}

🛠️ Configuration

While npm-run-mcp-server works instantly, you might not want your AI to have access to every script (like eject or publish). You can control this by creating an npm-run-mcp.config.json file in your project root.

Example Config

Create npm-run-mcp.config.json next to your package.json:

Shortened. The full README is on GitHub.