MCP Server Manager

🚀 MCP Server Manager

A backend Python application that provides both Model Context Protocol (MCP) and FastAPI web interfaces for managing and integrating MCP servers used in conjunction with the Claude desktop version.

🚀 Quick Start

The MCP Server Manager is a versatile tool designed to streamline the management and integration of MCP servers with the Claude desktop version. It offers a range of features to enhance your experience.

✨ Features

• Register and manage MCP servers from a central location.
• Enable or disable MCP servers for use with the Claude desktop version.
• Test server commands before registration.
• Restart the Claude desktop version after configuration changes.
• Launch the FastAPI server directly from Claude via MCP.
• Access features through both the Web UI and MCP interface.

📦 Installation

Prerequisites

• Python 3.13 or higher
• pip (Python package installer)
• Claude desktop version (for full functionality)

Clone the Repository (if applicable)

git clone https://github.com/yourusername/mcp-commander.git
cd mcp-commander/mcp_server_manager

Create a Virtual Environment

# Use venv
python -m venv .venv

# Activate the virtual environment
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

Install Dependencies

Choose one of the following methods:

# Use pip and requirements.txt
pip install -r requirements.txt

# Or use pip and pyproject.toml (recommended)
pip install -e .

💻 Usage Examples

Web Interface (Recommended)

The web interface provides a user - friendly way to manage your MCP servers.

uvicorn main:app --host 127.0.0.1 --port 8000

Then open your browser and navigate to http://127.0.0.1:8000

• --host 127.0.0.1: Restrict access to localhost only.
• --host 0.0.0.0: Make the server accessible to other devices on the network (if needed).
• --port 8000: The port on which the application runs.

MCP Interface (Optional)

If you need to access MCP functionality directly (e.g., for integration with the Claude desktop version):

python mcp_manager/mcp_server.py

The MCP server runs in standard input/output mode, meaning it reads from standard input and writes to standard output, which is the format expected by the MCP protocol.

MCP Tools

The MCP Server Manager provides the following tools via the Model Context Protocol:

1. restart_claude_desktop - Find, terminate, and restart the Claude desktop application.
2. set_server_enabled_status - Enable or disable an MCP server for use with the Claude desktop version.
3. install_mcp_server - Register a new MCP server configuration.
4. start_fastapi_server - Start the FastAPI server and open it in the default web browser to view the interface.

Using the start_fastapi_server Tool

Through the Claude desktop version, you can directly use the MCP tool to start the web interface:

start_fastapi_server

You can also specify a custom port:

start_fastapi_server port=8080

This will:

1. Start the FastAPI server in the background.
2. Open the default web browser to view the interface.

📚 Documentation

File Structure

The project file structure is as follows:

mcp_commander/
├── mcp_server_manager/
│   ├── __init__.py
│   ├── server.py
│   └── utils.py
└── tests/
    └── test_server.py

Development

To run the development environment, follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/mcp-commander.git
   cd mcp-commander/mcp_server_manager
   

2. Create a virtual environment and install dependencies:

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use .venv\Scripts\activate
   pip install -r requirements.txt
   

3. Run the server:

   uvicorn main:app --host 127.0.0.1 --port 8000
   

4. Access the Web interface: http://127.0.0.1:8000

Logs

The log files are located in the mcp_server_manager/log/ directory, with the format mcp_server.log.

# View logs
tail -f mcp_server_manager/log/mcp_server.log

🔚 Conclusion

Thank you for using the MCP Server Manager! If you have any questions or suggestions, please feel free to contact the maintenance team.