Terminal MCP Server

🚀 終端 MCP 服務器

終端 MCP 服務器基於 Model Context Protocol (MCP)，可在遠程或本地執行命令。它支持通過 SSH 連接實現遠程命令執行，也能在本地環境運行指令，為用戶提供了靈活的命令執行方式。

English Documentation

🚀 快速開始

終端 MCP 服務器允許用戶在遠程或本地執行命令。你可以通過 SSH 連接到遠程設備，也可以在本地環境中運行指令。

✨ 主要特性

• 遠程命令執行：藉助 SSH 協議連接到遠程設備並執行命令。
• 本地命令執行：可直接在啟動服務器的本地環境中運行指令。
• 會話管理：提供 20 分鐘的活動會話，保障環境上下文的一致性。
• 多平臺兼容：支持 Mac、Linux 等多種操作系統。

📦 安裝指南

通過 Smithery 安裝

使用提供的鏈接在 Smithery 平臺上直接安裝終端 MCP 服務器。

手動安裝

1. 克隆項目倉庫：

git clone https://github.com/weidwonder/terminal-mcp-server.git

2. 進入項目目錄並安裝依賴：

cd terminal-mcp-server
npm install

💻 使用示例

啟動服務器

• 本地模式（不帶 SSH）：

node index.js --local

• 遠程模式（啟用 SSH）：

node index.js --ssh

通過 SSH 連接

確保目標設備已配置 SSH 密鑰認證。默認情況下，服務器將嘗試使用 ~/.ssh/id_rsa 密鑰進行連接。

執行命令

本地執行

直接在啟動的服務器環境中運行指令：

execute_command --local "your command"

遠程執行

通過 SSH 連接的目標設備上運行命令：

execute_command --ssh <target-host> "your command"

execute_command 工具

參數說明

示例

1. 本地運行簡單命令：

execute_command --local "echo 'Hello, World!'"

2. 遠程設備上執行復雜任務：

execute_command --ssh 192.168.1.100 "sudo apt update && sudo apt upgrade"

📚 詳細文檔

最佳實踐

命令執行

• 根據目標系統類型（Mac、Linux 等）調整命令。
• 使用完整路徑避免依賴關係問題。
• 對於需要保持環境的多步操作，使用 && 連接。

SSH 連接

• 提前配置 SSH 密鑰認證。
• 檢查密鑰文件是否存在（默認：~/.ssh/id_rsa）。
• 確保遠程設備上的 SSH 服務正常運行。

會話管理

• 使用 --local 或 --ssh 參數維護環境上下文。
• 複雜操作建議保持相同會話以維持環境一致性。
• 20 分鐘後若無活動，連接將自動斷開。

注意事項

⚠️ 重要提示

遠程執行命令時，確保目標設備的安全性。

⚠️ 重要提示

本地或遠程命令的權限取決於啟動服務器和 SSH 連接的用戶身份。

⚠️ 重要提示

長時間運行的任務可能需要額外的資源管理和監控。