MCP Server Management Scripts

What is MCP Server Management Scripts?

This repository contains shell scripts to easily start and manage MCP (Model Context Protocol) servers for development. It provides a start-mcp-servers.sh script to launch all configured servers and a manage-mcp-servers.sh script to list, stop, view logs, and bring servers to the foreground.

How to use MCP Server Management Scripts?

Make both scripts executable with chmod +x start-mcp-servers.sh manage-mcp-servers.sh. To start all MCP servers, run ./start-mcp-servers.sh (foreground) or ./start-mcp-servers.sh --background (background mode). Use ./manage-mcp-servers.sh with subcommands like list, stop, logs, and fg to manage running servers. Add new servers by editing the MCP_SERVERS array in start-mcp-servers.sh.

Key features of MCP Server Management Scripts

• Starts all configured MCP servers with a single command
• Foreground mode with server-name-prefixed output
• Background mode with automatic iTerm2, Terminal.app, tmux, or log fallback
• Lists running servers with their status
• Stops all or specific servers by number
• Views logs for specific servers in real-time
• Brings a background server to the foreground
• Automatically clears old log files on startup

Use cases of MCP Server Management Scripts

• Quickly launch multiple MCP servers for local development
• Monitor and troubleshoot servers via centralized log viewing
• Stop a malfunctioning server without affecting others
• Add a new MCP server to the startup list by editing one array

FAQ from MCP Server Management Scripts

What scripts are included?

The repository includes start-mcp-servers.sh for launching servers and manage-mcp-servers.sh for managing them (list, stop, logs, foreground).

How do I run servers in the background?

Run ./start-mcp-servers.sh --background (or -b). The script will first try iTerm2 tabs, then Terminal.app windows, then tmux sessions, and finally use background processes with log files.

How do I add a new MCP server?

Open start-mcp-servers.sh, find the MCP_SERVERS array at the top, and add your server command as a new line. The management script automatically picks it up.

How do I stop a specific server?

Use ./manage-mcp-servers.sh stop N where N is the server’s number as shown in the list command. To stop all servers, run ./manage-mcp-servers.sh stop.

How do I view logs for a server?

Run ./manage-mcp-servers.sh logs N to view logs for server N. In background mode, logs are saved to files named after each server. ./manage-mcp-servers.sh logs lists all log files.