Unplugin

v1.0.0Developer Toolsstable

A unified plugin for developers integrating MCP servers into modern JavaScript build tools, including Webpack, Rollup, Vite, and more.

mcpmcp-servermodelcontextprotocolrolluprollup-plugin
Share:
31
Stars
0
Downloads
0
Weekly
0/5

What is Unplugin?

Unplugin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified plugin for developers integrating mcp servers into modern javascript build tools, including webpack, rollup, vite, and more.

A unified plugin for developers integrating MCP servers into modern JavaScript build tools, including Webpack, Rollup, Vite, and more.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A unified plugin for developers integrating MCP servers into

Use Cases

Integrate MCP servers into Webpack, Rollup, and Vite build tools.
Enable unified plugin development across multiple JavaScript build systems.
situ2001

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMar 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx unplugin

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Unplugin

unplugin-mcp is a unified build-tool plugin that embeds an MCP server directly into your JavaScript bundler process — supporting Rollup, Vite, Webpack, and other unplugin-compatible tools. During development builds it exposes live tools for analyzing module dependencies, inspecting build configuration, debugging build errors, and examining bundle sizes, making it possible for AI assistants to introspect and assist with your build pipeline in real time. It is ideal for teams who want AI-augmented build debugging without running a separate server.

Prerequisites

  • Node.js 18+ and a package manager (pnpm, npm, or yarn)
  • An existing JavaScript project using Rollup, Vite, Webpack, or another unplugin-compatible bundler
  • An MCP-compatible client that supports SSE transport (such as Cursor IDE)
  • pnpm recommended for installation (the project uses pnpm workspaces)
1

Install the plugin package

Add unplugin-mcp as a dev dependency to your project. For Rollup-specific usage you can also use the dedicated rollup-plugin-mcp package.

pnpm add -D unplugin-mcp
# or for Rollup specifically:
pnpm add -D rollup-plugin-mcp
2

Configure the plugin in your bundler

Import the appropriate bundler-specific export from unplugin-mcp and add it to your plugins array. Choose which built-in tools to enable — ModuleTool and BundleSizeTool are Rollup-only while BuildConfigTool and BuildErrorTool work across bundlers.

// rollup.config.js
import { rollupPlugin as mcp } from 'unplugin-mcp';
import { ModuleTool, BuildConfigTool, BuildErrorTool, BundleSizeTool } from 'unplugin-mcp/tools';

export default defineConfig({
  plugins: [
    mcp({
      provideUnpluginMcpTools: () => [
        new ModuleTool(),
        new BuildConfigTool(),
        new BuildErrorTool(),
        new BundleSizeTool()
      ]
    })
  ]
});
3

Run your build in watch mode

Start the bundler in watch or dev mode. The MCP plugin will spin up an SSE server (default port 14514) that your MCP client can connect to while the build runs.

npx rollup -c --watch
# or for Vite:
npx vite
4

Connect your MCP client via SSE

Add the SSE endpoint to your MCP client configuration. Because this server runs inside your build process it uses HTTP/SSE transport rather than stdio.

// ~/.config/cursor/mcp.json
{
  "mcpServers": {
    "rollup": {
      "url": "http://localhost:14514/mcp/sse"
    }
  }
}
5

Query your build from the AI assistant

With the build running and the client connected, ask your AI assistant to analyze module graphs, inspect configuration, or diagnose build errors using the exposed tools.

Unplugin Examples

Client configuration

Cursor MCP config connecting to the unplugin-mcp SSE server started by your Rollup/Vite build.

{
  "mcpServers": {
    "unplugin-mcp": {
      "url": "http://localhost:14514/mcp/sse"
    }
  }
}

Prompts to try

Questions you can ask your AI assistant once the build plugin server is running.

- "What modules does src/index.ts import, directly and transitively?"
- "Show me the current Rollup build configuration"
- "There's a build error — what's causing it and how do I fix it?"
- "Which modules are contributing the most to bundle size?"
- "Are there any circular dependencies in my module graph?"

Troubleshooting Unplugin

MCP client cannot connect to localhost:14514

Ensure your bundler is actively running in watch/dev mode — the MCP server only exists while the build process is alive. Check that nothing else is occupying port 14514 and that your firewall allows localhost connections.

ModuleTool or BundleSizeTool not available

These tools are Rollup-only and will not be registered when using Webpack or other bundlers. Switch to Rollup or Vite (which uses Rollup under the hood) to access the full tool set.

Plugin not found after install

Verify the import path: use 'unplugin-mcp' for the main package and 'unplugin-mcp/tools' for the tool classes. If using a bundler-specific package like rollup-plugin-mcp, import from that package instead.

Frequently Asked Questions about Unplugin

What is Unplugin?

Unplugin is a Model Context Protocol (MCP) server that unified plugin for developers integrating mcp servers into modern javascript build tools, including webpack, rollup, vite, and more. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Unplugin?

Follow the installation instructions on the Unplugin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Unplugin?

Unplugin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Unplugin free to use?

Yes, Unplugin is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "unplugin": { "command": "npx", "args": ["-y", "unplugin"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Unplugin?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides