MCP Server Switcher

MCP server management tool

Developer tools Operating system automation #Server management #Configuration switching #GUI tool #MCP service .Python

rating : 2 points

downloads : 13

update time : 2025-04-28

What is MCP Server Switcher?

MCP Server Switcher is an intuitive graphical interface tool that helps users easily manage the configurations of multiple Model Context Protocol (MCP) servers. It allows you to enable or disable specific servers through simple checkbox operations without manually editing configuration files.

How to use MCP Server Switcher?

Simply start the application, add your server configurations, check the servers you want to enable, and then click Save. All operations are completed in a friendly graphical interface.

Use cases

This tool is particularly useful when you need to frequently switch between different MCP server configurations or manage multiple server configurations simultaneously. It simplifies the configuration management process and is especially suitable for non-technical users.

Main features

Multi-configuration managementYou can manage the configuration information of multiple MCP servers simultaneously, including names, commands, parameters, and environment variables.

One-click switchingYou can enable or disable specific server configurations through simple checkboxes without complex operations.

System tray integrationThe application can be minimized to the system tray for quick access and switching.

Auto-saveAll configuration changes will be automatically saved to the user directory to ensure that settings are not lost.

Advantages and limitations

Advantages

User-friendly graphical interface without command-line operations

Simplifies the complex server configuration management process

System tray integration provides convenient access

Configurations are automatically saved to reduce human errors

Limitations

Only supports MCP server configuration management

Requires a Python environment to run (except for the packaged version)

Advanced users may prefer to edit configuration files directly

How to use

Start the application

Double-click the application icon to start MCP Server Switcher.

Add server configuration

Click the 'Add' button and fill in the server name, command, and relevant parameters.

Enable the server

Check the checkbox next to the server configuration you want to enable.

Save the configuration

Click the 'Save configuration' button to apply your changes.

Usage examples

Development environment switchingDevelopers need to quickly switch between the local development server and the test server

Multi-project configuration managementManage the MCP server configurations of multiple projects simultaneously

Frequently Asked Questions

Where are the configuration files stored?

How to package the application?

Does it support the Windows system?

Related resources

PyQt6 documentation

Documentation for the GUI framework used by the application

Python official website

Official website of the Python programming language

GPL v3 license

Details of the license used by the project

🚀 MCP Server Switcher

MCP Server Switcher is a graphical interface tool designed to manage and switch MCP server configurations, offering a seamless experience for users dealing with multiple server setups.

🚀 Quick Start

Launch the application.
Add, edit, or delete server configurations.
Check the servers you want to enable.
Click "Save Configuration" to apply the changes.

Configuration files are saved in the following locations:

All configurations: ~/.mcp_switcher/all_mcp_config.json
Currently active configuration: ~/.codeium/windsurf/mcp_config.json

✨ Features

Manage multiple MCP server configurations.
Easily enable/disable specific servers using checkboxes.
Edit server configurations (name, command, parameters, and environment variables).
Integrate with the system tray for quick access.
Automatically save configurations to the user directory.

💻 Usage Examples

Basic Usage

To start using the MCP Server Switcher, follow these steps:

# Launch the application
# After launching, you can add, edit, or delete server configurations through the GUI

Advanced Usage

If you need to make more complex configuration changes, you can directly edit the configuration files:

# Edit the all_mcp_config.json file to manage all server configurations
nano ~/.mcp_switcher/all_mcp_config.json

# Edit the mcp_config.json file to manage the currently active server configuration
nano ~/.codeium/windsurf/mcp_config.json

🔧 Technical Details

This application is built on the following technology stack:

Python
PyQt6 (GUI framework)
JSON (configuration file format)

📚 Documentation

Packaging Instructions

This application is packaged into an executable file using PyInstaller. Use the following command to package the application:

pyinstaller --name="MCP Server Switcher" --windowed --icon=resources/icon_.png --add-data="all_mcp_config.json:." --add-data="resources/*.png:resources" main.py