终端 MCP 服务器

English Documentation

终端 MCP 服务器是一个基于 Model Context Protocol (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连接的用户身份。
• 资源限制：长时间运行的任务可能需要额外的资源管理和监控。