MCP Autostarter
An intelligent MCP server that restarts Claude's MCP handler process without disrupting the UI. Unlike traditional restart tools that kill the entire Claude Desktop application, this tool surgically restarts only the Node.js process handling MCP connections, allowing for seamless plugin reloading.
Why MCP Autostarter?
When developing or installing MCP plugins, you need to restart Claude to load new configurations. Traditional approaches kill the entire Claude Desktop app, disrupting your workflow. MCP Autostarter is smarter - it:
- Identifies the MCP handler process - Finds the specific Node.js process managing MCP connections
- Gracefully restarts it - Sends SIGTERM first, then SIGKILL if needed
- Lets Claude auto-recover - Claude Desktop detects the disconnection and automatically restarts the handler
- Keeps your UI intact - No window closing, no lost context
Installation
The easiest way is to let Claude Desktop install it automatically via npx. Just add it to your configuration!
Configuration
Add to your Claude Desktop MCP settings:
That's it! No manual installation needed - npx will handle everything automatically.
Usage
Once configured, you can use these commands in Claude:
Smart MCP Restart (Recommended)
This intelligently restarts only the MCP handler process, keeping Claude Desktop running.
Full Claude Restart
This fully restarts Claude Desktop (use only if MCP restart fails).
Check Status
Shows the current status of MCP handler and Claude Desktop processes.
How It Works
- Process Detection: Uses intelligent heuristics to find the Node.js process running MCP servers
- Graceful Shutdown: Sends SIGTERM to allow clean shutdown
- Automatic Recovery: Claude Desktop detects the disconnection and restarts the handler
- Verification: Confirms the new process is running before reporting success
Platform Support
- ✅ macOS
- ✅ Windows
- ✅ Linux
Development
Comparison with mcp-server-restart
Feature | mcp-autostarter | mcp-server-restart |
---|---|---|
Restarts MCP handler only | ✅ | ❌ |
Keeps UI running | ✅ | ❌ |
Cross-platform | ✅ | ❌ (Mac only) |
Process detection | Intelligent | Basic |
Graceful shutdown | ✅ | ❌ |
License
MIT
You must be authenticated.
An intelligent MCP server that enables seamless restarting of Claude's MCP handler process without disrupting the UI, allowing for plugin reloading without closing the entire Claude Desktop application.
Related MCP Servers
- AsecurityAlicenseAqualityMCP server that builds itself by creating new tools as needed based on user requests (Requires restart of Claude Desktop to use newly created tools).Last updated -413PythonThe Unlicense
- AsecurityAlicenseAqualityAn MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.Last updated -26TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that automatically reads the Claude Desktop configuration file and presents all available MCP services in an easy-to-copy format at the top of the tools list.Last updated -113JavaScriptMIT License
- -securityAlicense-qualityAn MCP server that provides persistent memory capabilities for Claude, offering tiered memory architecture with semantic search, memory consolidation, and integration with the Claude desktop application.Last updated -5PythonMIT License