unplugin-mcp

by situ2001

31 stars
324 downloads
Not rated
GitHub

About

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

Details

Author
situ2001
GitHub stars
31
Downloads
324
Categories
Developer Tools

- Cross-platform MCP integration for multiple JavaScript build tools.
- Bi-directional AI integration for both reading and modifying builds.
- Rich built-in tools for module, config, error, and size analysis.
- Extensible tool framework via the UnpluginMcpTool interface.
- Seamless integration with build tool plugin hooks (e.g., Rollup).
- Persistent server that stays alive in watch mode.
- Standard HTTP + SSE transport for broad MCP client compatibility.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name unplugin-mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the plugin with pnpm add -D unplugin-mcp (or the bundler-specific package like rollup-plugin-mcp). Add it to your build config (e.g., rollup.config.js) and provide built-in or custom tools via the provideUnpluginMcpTools option. The MCP server starts automatically when you run your build tool in watch mode. Then configure your MCP client (e.g., Cursor) to connect to the server’s SSE endpoint, typically http://localhost:14514/mcp/sse.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

unplugin-mcp

GitHub Repo
npm version
npm download
npm license

> [!IMPORTANT]
> This is a work in progress. Not ready for production use yet. If you are interested in and want to help, feel free to open an issue or PR.

A unified MCP (Model Context Protocol) plugin that creates and manages an MCP Server and provides MCP tools by which AI can know more about your codebase, build tools, and even control the build process. It works with multiple JavaScript build tools supported by unplugin, including Rollup, Vite, Webpack, and others.

Here is the vision of this plugin, to provide a unified MCP Server and MCP tools to MCP Client.

flowchart LR
    subgraph "Build tools"
        Rollup["Rollup"]
        Vite["Vite"]
        ESBuild["ESBuild"]
        Webpack["Webpack"]
        Rspack["Rspack"]
        Rolldown["Rolldown"]
    end

subgraph "unplugin-mcp (This plugin)"
unplugin["unplugin"]
McpTool["UnpluginMcpTool"]
McpServer["MCP Server"]
HTTPServer["HTTP Server"]
end

subgraph "MCP Clients"
Cursor["Cursor"]
VSCode["VSCode"]
More["More"]
end

Rollup & Webpack & Vite & ESBuild & Rspack & Rolldown --> unplugin
unplugin --> McpTool
McpTool --> McpServer
McpServer --> HTTPServer
HTTPServer --> Cursor & VSCode & More

Features

- 🚀 Cross-Platform MCP Integration: Creates and manages an MCP server seamlessly across multiple build tools.
- 🧩 Bi-directional AI Integration: Not only provides context to AI assistants about your codebase, but also enables AI to actively modify and control your build process.
- 🧰 Rich built-in tools: Collection of built-in tools for analyzing module dependencies, inspecting build configuration, debugging error messages, and so on.
- 🛠️ Extensible Tool Framework: Create custom MCP tools with the simple UnpluginMcpTool interface to expose project-specific information or functionality.
- 🔍 Build Process Integration: Seamlessly integrates at any point in the plugin chain and hooks of your build tools like Rollup.
- 🔄 Persistent Server: Keeps running even after build completion in watch mode, enabling continuous AI interaction.
- 🌐 Standard Transport Layer: Uses HTTP and Server-Sent Events (SSE) for broad compatibility with AI assistants implementing the MCP protocol.

Installation

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.