MCP Server Management Scripts

🚀 MCP 服務器管理腳本

本倉庫中的腳本可助力你輕鬆啟動與管理開發階段的 MCP（模型上下文協議）服務器，提升開發與維護效率。

🚀 快速開始

確保兩個腳本具備可執行權限：

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

✨ 主要特性

• 啟動腳本：start-mcp-servers.sh 用於啟動所有 MCP 服務器。
• 管理腳本：manage-mcp-servers.sh 輔助你管理運行中的 MCP 服務器，支持列出、停止、查看日誌等操作。

📦 安裝指南

啟動 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  # 停止第一個服務器

查看日誌

列出所有日誌文件：

./manage-mcp-servers.sh logs

查看特定服務器的日誌（按編號）：

./manage-mcp-servers.sh logs 1  # 查看第一個服務器的日誌

將服務器帶到前臺

./manage-mcp-servers.sh fg 1  # 將第一個服務器帶到前臺

若無法將服務器帶到前臺，會在即時更新中顯示日誌文件。

添加新 MCP 服務器

添加新的 MCP 服務器，只需編輯 start-mcp-servers.sh 文件：

1. 打開 start-mcp-servers.sh。
2. 在文件頂部找到 MCP_SERVERS 數組。
3. 將新服務器的路徑添加到數組中，例如：

"/path/to/your/new/mcp_server"

4. 保存並關閉文件。 新服務器將在下次運行腳本時啟動。

日誌管理

自動清理日誌

默認情況下，腳本會自動刪除舊的日誌文件以節省空間。你可通過修改 LOG_RETENTION_DAYS 變量來控制日誌保留天數：

# 在 start-mcp-servers.sh 中找到以下行：
LOG_RETENTION_DAYS=7  # 例如，保留 7 天內的日誌

前臺模式與後臺模式

• 前臺模式：服務器在當前終端窗口運行，關閉窗口時停止。
• 後臺模式：服務器在後臺持續運行，即便關閉終端窗口也不受影響。

🔧 技術細節

啟動腳本（start-mcp-servers.sh）

1. 檢查所有 MCP 服務器的狀態。
2. 按需啟動未運行的服務器。
3. 提供即時輸出，監控服務器狀態。
4. 自動管理後臺進程和日誌文件。

管理腳本（manage-mcp-servers.sh）

• 提供多種命令控制服務器。
• 顯示即時狀態和日誌。
• 支持在前臺或後臺模式下運行服務器。

📚 詳細文檔

故障排除

問題：無法啟動某個 MCP 服務器

1. 檢查路徑是否正確。
2. 確保服務器文件可執行。
3. 查看日誌文件獲取錯誤信息：

./manage-mcp-servers.sh logs <server_number>

問題：後臺進程未運行

1. 檢查終端窗口是否關閉。
2. 確保後臺模式支持（iTerm2 或 Terminal.app）。
3. 使用 tmux 或其他會話管理工具保持連接。

常見錯誤代碼和日誌信息

• 代碼 1：路徑不存在或不可訪問。
• 代碼 2：服務器文件不可執行。
• 代碼 3：依賴服務未運行。
• 日誌示例：

[INFO] Starting MCP Server 1...
[ERROR] Failed to start server: Permission denied

總結

這些腳本極大地便利了多個 MCP 服務器的管理，支持前臺和後臺模式，提供詳細的即時狀態與日誌信息。通過簡單命令即可實現服務器的啟動、停止和監控，有效提升開發與維護效率。