Terminal MCP Server

产品定位

Terminal MCP Server 是一个模型上下文协议（MCP）服务器，允许在本地或远程主机上执行命令。它为AI模型和其他应用程序提供了一个简单而强大的接口，用于在本地机器或通过SSH在远程主机上执行系统命令。

核心功能

• 本地命令执行：直接在本地机器上执行命令
• 远程命令执行：通过SSH在远程主机上执行命令
• 会话持久化：支持持久会话，可以在指定时间内（默认20分钟）重用相同的终端环境
• 环境变量：为命令设置自定义环境变量
• 多种连接方式：通过stdio或SSE（服务器发送事件）连接

适用场景

• AI模型需要执行系统命令的场景
• 需要在远程主机上执行命令的场景
• 需要持久化会话环境的场景

工具列表

• execute_command工具：用于在本地或远程主机上执行命令的核心功能

常见问题解答

• 远程命令执行需要提前设置SSH密钥认证
• 本地命令执行将在启动服务器的用户上下文中运行
• 会话超时为20分钟，之后连接将自动关闭

使用教程

使用依赖

需要安装Node.js和npm

安装教程

通过Smithery安装

npx -y @smithery/cli install @weidwonder/terminal-mcp-server --client claude

手动安装

git clone https://github.com/weidwonder/terminal-mcp-server.git
cd terminal-mcp-server
npm install
npm run build

调试方式

启动服务器（stdio模式）

npm start
# 或
node build/index.js

启动服务器（SSE模式）

npm run start:sse
# 或
node build/index.js --sse

使用MCP Inspector工具测试

npm run inspector

许可证

None