终端 MCP 服务器

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

特征

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

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装终端 mcp 服务器：

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

手动安装

# Clone the repository
git clone https://github.com/weidwonder/terminal-mcp-server.git
cd terminal-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

用法

启动服务器

# Start the server using stdio (default mode)
npm start

# Or run the built file directly
node build/index.js

以 SSE 模式启动服务器

SSE（服务器发送事件）模式允许您通过 HTTP 远程连接到服务器。

# Start the server in SSE mode
npm run start:sse

# Or run the built file directly with SSE flag
node build/index.js --sse

您可以使用以下命令行选项自定义 SSE 服务器：

选项	描述	默认
`--port`或`-p`	监听的端口	8080
`--endpoint`或`-e`	端点路径	/sse
`--host`或`-h`	绑定到的主机	本地主机

自定义选项的示例：

# Start SSE server on port 3000, endpoint /mcp, and bind to all interfaces
node build/index.js --sse --port 3000 --endpoint /mcp --host 0.0.0.0

这将启动服务器并监听http://0.0.0.0:3000/mcp上的 SSE 连接。

使用 MCP Inspector 进行测试

# Start the MCP Inspector tool
npm run inspector

execut_command工具

execute_command 工具是终端 MCP 服务器提供的核心功能，用于在本地或远程主机上执行命令。

参数

范围	类型	必需的	描述
命令	细绳	是的	要执行的命令
主持人	细绳	不	要连接的远程主机。如果未提供，则命令将在本地执行。
用户名	细绳	指定主机时必填	SSH 连接的用户名
会议	细绳	不	会话名称，默认为“default”。相同的会话名称将重复使用相同的终端环境 20 分钟
环境	目的	不	环境变量，默认为空对象

示例

本地执行命令

{
  "command": "ls -la",
  "session": "my-local-session",
  "env": {
    "NODE_ENV": "development"
  }
}

在远程主机上执行命令

{
  "host": "example.com",
  "username": "user",
  "command": "ls -la",
  "session": "my-remote-session",
  "env": {
    "NODE_ENV": "production"
  }
}

使用 AI 助手进行配置

使用 Roo 代码进行配置

打开 VSCode 并安装 Roo Code 扩展
打开 Roo Code 设置文件： ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
添加以下配置：

对于 stdio 模式（本地连接）

{
  "mcpServers": {
    "terminal-mcp": {
      "command": "node",
      "args": ["/path/to/terminal-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

对于 SSE 模式（远程连接）

{
  "mcpServers": {
    "terminal-mcp-sse": {
      "url": "http://localhost:8080/sse",
      "headers": {}
    }
  }
}

如果您已自定义，请将localhost:8080/sse替换为您的实际服务器地址、端口和端点。

使用 Cline 配置

打开 Cline 设置文件： ~/.cline/config.json
添加以下配置：

对于 stdio 模式（本地连接）

{
  "mcpServers": {
    "terminal-mcp": {
      "command": "node",
      "args": ["/path/to/terminal-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

对于 SSE 模式（远程连接）

{
  "mcpServers": {
    "terminal-mcp-sse": {
      "url": "http://localhost:8080/sse",
      "headers": {}
    }
  }
}

使用 Claude Desktop 进行配置

打开 Claude Desktop 设置文件： ~/Library/Application Support/Claude/claude_desktop_config.json
添加以下配置：

对于 stdio 模式（本地连接）

{
  "mcpServers": {
    "terminal-mcp": {
      "command": "node",
      "args": ["/path/to/terminal-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

对于 SSE 模式（远程连接）

{
  "mcpServers": {
    "terminal-mcp-sse": {
      "url": "http://localhost:8080/sse",
      "headers": {}
    }
  }
}

最佳实践

命令执行

在运行命令之前，最好确定系统类型（Mac、Linux 等）
使用完整路径来避免与路径相关的问题
对于需要维护环境的命令序列，使用&&连接多个命令
对于长时间运行的命令，请考虑使用nohup或screen / tmux

SSH 连接

确保设置了基于 SSH 密钥的身份验证
如果连接失败，请检查密钥文件是否存在（默认路径： ~/.ssh/id_rsa ）
确保远程主机上正在运行 SSH 服务

会话管理

使用 session 参数来维护相关命令之间的环境
对于需要特定环境的操作，使用相同的会话名称
请注意，会话将在 20 分钟不活动后自动关闭

错误处理

命令执行结果包括stdout和stderr
检查 stderr 以确定命令是否执行成功
对于复杂的操作，添加验证步骤以确保成功

重要提示

对于远程命令执行，必须提前设置基于 SSH 密钥的身份验证
对于本地命令执行，命令将在启动服务器的用户上下文中运行
会话超时为20分钟，超过20分钟后连接将自动关闭

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP 服务器允许 AI 模型通过 SSH 在本地机器或远程主机上执行系统命令，支持持久会话和环境变量。

Related MCP Servers

mcp-server-commands
g0t4
A
security
A
license
A
quality
An MCP server to run commands.
Last updated -
2
933
160
TypeScript
MIT License
Terminal MCP Server
theailanguage
-
security
F
license
-
quality
An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
Last updated -
38
Python
MCP Terminal
sichang824
A
security
A
license
A
quality
A server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).
Last updated -
3
6
Python
MIT License
Lilith Shell
charles-adedotun
-
security
A
license
-
quality
An enhanced MCP server that grants AI assistants the ability to execute terminal commands on a user's system with improved security controls, designed for use in controlled environments.
Last updated -
Python
MIT License

View all related MCP servers

Terminal MCP Server