MCP-Hotplug
by Darek3399
README.md
<div style="max-width: 1000px; margin: 0 auto;">
<div align="right" style="display: flex; justify-content: space-between; align-items: center; padding-top: 8px;">
<span><a id="top"></a><a href="docs/donate.md" title="Support the project"><img align="left" width="24" height="24" style="float: none; display: block;" src="docs/images/coffee-button.svg" alt="Support the project"></a></span>
<span><a href="README.md"><img style="display: inline-block; vertical-align: middle;" src="https://img.shields.io/badge/-English-15322F?style=for-the-badge" height="24" vspace="7" alt="English"></a> <a href="README.ru.md"><img style="display: inline-block; vertical-align: middle;" src="https://img.shields.io/badge/-Русский-22252A?style=for-the-badge" height="24" vspace="7" alt="Русский"></a></span>
</div>
<div align="center">
<br clear="all">
<img style="display: block; margin: 18px auto -16px;" src="src/McpHotplug/Resources/MCPHotplug.ico" width="72" height="72" alt="MCP Hotplug">
<h1 style="margin-top: 0;">mcp<b>Hotplug</b></h1>
<h3>One endpoint for all your MCP servers. Switch tools without restarting the chat.</h3>
<p>
MCP Hotplug combines local and remote MCP servers in one Windows app.<br>
Connect your AI client once, then enable only the servers you need.
</p>
<p>
<a href="#quick-start"><img src="https://img.shields.io/badge/WinGet-Darek3399.MCPHotplug-0078D4?logo=windows&logoColor=white" alt="WinGet package"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-2ea44f?logo=opensourceinitiative&logoColor=white" alt="MIT License"></a>
<a href="https://mcp.so/server/MCP-Hotplug/Darek3399"><img src="https://img.shields.io/badge/MCP.so-MCP_Hotplug-f97316?logo=modelcontextprotocol&logoColor=white" alt="MCP Hotplug on MCP.so"></a>
<a href="https://glama.ai/mcp/servers/Darek3399/MCP-Hotplug"><img src="https://glama.ai/mcp/servers/Darek3399/MCP-Hotplug/badges/score.svg?v=2" alt="MCP Hotplug score on Glama"></a>
</p>
<p><sub>Windows 10/11 · No public tunnel is required for local desktop clients</sub></p>
</div>
<p align="center">
<img src="docs/images/Main_ENG.svg" width="900" alt="MCP Hotplug dashboard">
</p>
## Why MCP Hotplug?
- **One endpoint:** connect several local and remote MCP servers through a single address.
- **Live switching:** enable or disable servers while you work.
- **Task presets:** save server combinations and switch between workflows quickly.
- **Local servers in web AI:** optionally expose local STDIO servers through Tailscale Funnel.
> **No tunnel is needed for local desktop clients.** Tailscale Funnel is an optional setup for compatible web-based AI clients that need remote access.
## Quick start
1. Download the installer from the [latest release page](https://github.com/Darek3399/MCP-Hotplug/releases/latest), or install via **WinGet**:
```powershell
winget install Darek3399.MCPHotplug
```
2. Install and launch MCP Hotplug.
3. Open **MCP Services** and add an MCP server. You can paste its configuration from the server documentation.
4. Click **Verify & Add**. If the server depends on an app that is currently closed, choose **Save Without Check**.
5. In your MCP client settings, add a **Streamable HTTP** connection and use this local URL:
`http://127.0.0.1:8004/mcp`
If your client uses a JSON configuration file, add:
```json
{
"mcpServers": {
"mcp-hotplug": {
"type": "http",
"url": "http://127.0.0.1:8004/mcp"
}
}
}
```
<p>
<img src="docs/images/Settings_ENG.svg" width="900" alt="MCP Hotplug settings and connection URLs">
</p>
## Remote access with Tailscale Funnel
During the initial setup, authorize your device in Tailscale and enable Funnel. After that, Hotplug uses the device's stable name and Funnel URL: you usually do not need to sign in again or obtain a new URL every time Hotplug starts. The address remains available while the device is authorized and running, and Funnel is enabled.
Unlike temporary tunnels, this address does not need to be reacquired on every launch. Terms vary by provider; some alternatives offer persistent addresses only on paid plans.
<table>
<tr>
<td width="33%" align="center" valign="top">
<img src="docs/images/Tailscale_Welcome.png" width="100%" alt="Step 1: launch Tailscale">
<br><b>1. Launch Tailscale</b>
</td>
<td width="33%" align="center" valign="top">
<img src="docs/images/Tailscale_Device_Connect.png" width="100%" alt="Step 2: sign in and connect your device">
<br><b>2. Sign in once</b>
</td>
<td width="33%" align="center" valign="top">
<img src="docs/images/Tailscale_Funnel.png" width="100%" alt="Step 3: enable Tailscale Funnel">
<br><b>3. Enable Funnel</b>
</td>
</tr>
</table>
> **Security note:** the public URL may be reachable from the internet. Do not share it publicly, and only enable Funnel when remote access is needed.
## Features
### Switch servers during a chat
Enable and disable MCP servers during an active conversation without manually reconnecting your client.
<p>
<img src="docs/images/MSP_Servises_ENG.svg" width="900" alt="MCP server management">
</p>
### Use presets for different tasks
Save a combination of servers as a preset and switch between setups for different workflows, such as development or working with files.
### Connect local STDIO servers
Hotplug brings local command-line MCP servers—started with tools such as `npx`, `uvx`, `python`, and others—into a shared gateway.
### Limit access to folders
For the built-in Filesystem MCP server, choose which folders are available. Grant access only to the directories needed for your task.
## How it works
<p>
<img src="docs/images/architecture-en.svg" width="900" alt="MCP Hotplug architecture">
</p>
1. Your AI client connects to the MCP Hotplug endpoint.
2. Hotplug routes requests to enabled MCP servers.
3. Local servers can use STDIO; remote servers can use HTTP.
4. If a browser-based client needs remote access, it can be enabled separately through Tailscale Funnel.
## Tools
Hotplug exposes two meta-tools — `all_tools` and `call_tool` — for discovering and calling tools from connected servers. This avoids sending every server's tool description to the client at once; the actual effect depends on the client and model.
- **`all_tools`** — returns the latest cached tool catalog snapshot from enabled MCP servers, including `tool_id`, `inputSchema`, per-server status, and `catalog_revision`.
- **`call_tool`** — validates arguments against the cached `inputSchema` and routes the call to the target server using `tool_id`, `catalog_revision`, and `arguments`.
## Security and limitations
- **Third-party MCP servers** run on your computer as your Windows user. Only add commands and servers you trust.
- **Filesystem MCP** can read, modify, and delete files in allowed folders. Avoid granting access to the entire drive unless needed.
- **Tailscale Funnel** exposes a public URL. Do not share it publicly, and disable Funnel when you do not need remote access.
- **Server secrets** — environment variables and authorization headers — are stored locally. According to the project's current documentation, they are stored in plain text; keep this in mind when handling keys and tokens.
See [SECURITY.md](SECURITY.md) for details.
## System requirements
- Windows 10 x64 (version 1903+) or Windows 11.
- .NET Framework 4.8.
- Download the Windows x64 installer from [GitHub Releases](https://github.com/Darek3399/MCP-Hotplug/releases/latest).
## Technical details
- **Platform:** Windows.
- **UI languages:** Russian and English.
- **MCP transports:** STDIO and HTTP.
- **Local endpoint:** `http://127.0.0.1:8004/mcp`.
- **Meta-tools:** `all_tools` and `call_tool`.
- **Optional remote access:** Tailscale Funnel.
- **Child-process management:** Windows Job Objects.
## Contributing
Found a bug or have an idea for an improvement?
- [Open an issue](https://github.com/Darek3399/MCP-Hotplug/issues).
- [Browse the source code](https://github.com/Darek3399/MCP-Hotplug).
## License
Released under the [MIT License](LICENSE).
## Support the project
If MCP Hotplug is useful to you, you can support its development:
<p>
<a href="docs/donate.md">
<img src="docs/images/coffee-en.svg" width="500" alt="Support MCP Hotplug development">
</a>
</p>
---
<p align="center">
<a href="README.ru.md">Русский</a> ·
<a href="SECURITY.md">Security</a> ·
<a href="THIRD_PARTY_NOTICES.md">Third-party notices</a> ·
<a href="docs/donate.md">Support the project</a>
</p>
</div>
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues