MCP Server Manager

What is MCP Server Manager?

MCP Server Manager is a Python-based system that wraps stdio-based Model Context Protocol (MCP) servers with Supergateway to expose them as SSE endpoints and provides a web-based inspector for debugging. It is aimed at developers using MCP servers with AI assistants like Cursor and Claude Desktop.

How to use MCP Server Manager?

Install dependencies with pip install -r requirements.txt, copy .env.example to .env and add API keys, then run make run-servers to start all servers with auto-restart. Start the web inspector with make run-inspector and view the URL shown in the output. Servers are configured in mcp_config.json and can be added via python mcp_servers.py add.

Key features of MCP Server Manager?

• Auto-updates npm packages and git repos before starting
• Background monitoring restarts crashed servers up to 3 times
• Web inspector for debugging and testing MCP servers
• SSE conversion wraps stdio servers for HTTP/SSE access
• Works with Cursor, Claude Desktop, and other AI assistants

Use cases of MCP Server Manager?

• Debug a specific MCP server using the web inspector
• Add a new MCP server (e.g., GitHub) with custom command and environment variables
• Use with Cursor AI by adding SSE endpoints to ~/.cursor/mcp.json
• Restart a problematic server individually with make restart-server SERVER=<name>
• Run servers in development mode without auto-restart using KEEP_ALIVE=0

FAQ from MCP Server Manager

What are the system dependencies?

Python, required packages from requirements.txt, and Node.js/npx for server commands that use npm.

Where are server logs stored?

Each server writes logs to /tmp/<server_name>.log.

How does auto-restart work?

If a server crashes, it is automatically restarted up to three times before giving up.

How can I add a new MCP server?

Use python mcp_servers.py add with the server name, command, arguments, environment variables, and port.

What transport does MCP Server Manager use?

It wraps stdio-based MCP servers so they are accessible via HTTP/SSE on their assigned ports.