MCP Server Management Scripts

MCP 服务管理脚本

此仓库包含一些脚本，便于在开发过程中启动和管理 MCP（Model Context Protocol）服务。

脚本概览

• start-mcp-servers.sh：启动所有 MCP 服务
• manage-mcp-servers.sh：帮助你管理正在运行的 MCP 服务（列出、停止、查看日志等）

开始使用

确保两个脚本都具有可执行权限：

chmod +x start-mcp-servers.sh manage-mcp-servers.sh

启动 MCP 服务

启动所有 MCP 服务：

./start-mcp-servers.sh

默认情况下，此操作会：

1. 清除所有现有日志文件
2. 在前台运行所有服务，并在当前终端中显示输出
3. 为每行输出添加服务名称前缀，以便于识别

在后台模式下运行

如果你希望在后台运行服务：

./start-mcp-servers.sh --background

在后台模式下，脚本会按以下优先顺序尝试使用其中一种方式启动服务：

1. iTerm2 标签页（如果正在使用 iTerm2）
2. Terminal.app 窗口（如果正在使用 Terminal.app）
3. tmux 会话（如果 tmux 可用）
4. 后台进程并将日志写入文件（备用方式）

命令行选项

./start-mcp-servers.sh --help

可用选项：

• --background、-b：在后台模式下运行服务
• --help、-h：显示帮助信息

管理 MCP 服务

管理脚本提供了多个命令，帮助你管理正在运行的 MCP 服务：

显示帮助信息

./manage-mcp-servers.sh help

列出正在运行的服务

./manage-mcp-servers.sh list

这会显示所有已配置的服务及其运行状态。

停止服务

停止所有服务：

./manage-mcp-servers.sh stop

停止指定服务（按编号）：

./manage-mcp-servers.sh stop 1  # Stop the first server

查看日志

列出所有日志文件：

./manage-mcp-servers.sh logs

查看指定服务的日志（按编号）：

./manage-mcp-servers.sh logs 1  # View logs for the first server

将服务切换到前台

./manage-mcp-servers.sh fg 1  # Bring the first server to foreground

如果无法将服务切换到前台，脚本会实时显示其日志文件内容。

添加新的 MCP 服务

添加新的 MCP 服务，只需编辑 start-mcp-servers.sh 文件：

1. 打开 start-mcp-servers.sh
2. 找到文件顶部的 MCP_SERVERS 数组
3. 在数组中新增一行，添加你的服务命令

MCP_SERVERS=(
  "npx @agentdeskai/browser-tools-server"
  "npx -y @modelcontextprotocol/server-sequential-thinking"
  "npx your-new-server-command"  # Add your new server here
)

管理脚本会自动从启动脚本中获取新服务。

日志管理

脚本会按以下方式处理日志：

1. 自动清理：启动服务时，会自动清除现有日志文件，防止日志文件过大。

2. 前台模式：在默认的前台模式下，日志会直接显示在终端中，并带有服务名称前缀。

3. 后台模式：在后台模式下，日志会保存到以各服务命名的文件中（例如，browser-tools-server.log）。

4. 查看日志：使用 ./manage-mcp-servers.sh logs 查看后台进程的日志。

工作原理

• 启动脚本在顶部的数组中定义所有 MCP 服务
• 脚本会检测你的环境，并以最合适的方式启动服务
• 管理脚本会从启动脚本中提取服务配置
• 脚本使用 pgrep 查找正在运行的进程，并使用 pkill 停止进程
• 查看日志时，脚本使用 tail -f 实时显示更新内容

故障排除

如果遇到问题：

1. 确保两个脚本都具有可执行权限（chmod +x *.sh）
2. 检查数组中的服务命令是否正确
3. 查看当前目录中的日志文件，查找错误信息
4. 尝试手动运行服务命令，确认其是否正常运行