MCP Server Manager
Overview
MCP Server Manager is a Python script designed to manage Model Context Protocol (MCP) servers, utilizing Supergateway to facilitate Server-Sent Events (SSE).
To use MCP Server Manager, make the script executable and configure your MCP servers using the provided commands. You can add, list, run, and remove server configurations through the command line.
- Manage multiple MCP servers with custom commands and environment variables. - Support for both stdio and SSE MCP servers. - Run servers in the background or foreground. - Automatically wrap stdio servers with Supergateway. - Cleanly manage background processes.
- Managing multiple API servers for different applications.
- Running background processes for server management.
- Configuring and launching servers with specific environment settings.
Add to your AI client
Use these steps to connect MCP Server Manager in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-manager-owenqian": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-manager-owenqian": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-manager-owenqian": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-manager-owenqian": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-manager-owenqian": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-manager-owenqian": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-manager-owenqian"
]
}
}
}FAQ
What is required to run MCP Server Manager?
You need Python 3.6+ and Supergateway installed in your PATH.
Can I run multiple servers at once?
Yes! You can run multiple servers simultaneously, with options for background execution.
How do I stop background servers?
Use the command `python mcp_servers.py stop` to stop all background servers.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3202,"uuid":"269d438d-967d-4c5e-89a7-5bbb41a89583","name":"mcp-server-manager","title":"MCP Server Manager","description":"","avatar_url":"https://avatars.githubusercontent.com/u/13374125?v=4","created_at":"$D2025-03-18T05:56:26.112Z","updated_at":"$D2025-03-18T17:30:44.409Z","status":"created","author_name":"OwenQian","author_avatar_url":"https://avatars.githubusercontent.com/u/13374125?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/OwenQian/mcp-server-manager","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-24 03:18:49\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]