Evol Terminal MCP
Evol Terminal MCP Server 提供终端控制能力，支持执行系统命令、运行脚本和进程管理。
功能概述
| 功能模块 | 描述 |
|---|---|
| 命令执行 | 执行 Shell/PowerShell 命令 |
| 脚本运行 | 运行各类脚本文件 |
| 进程管理 | 启动、监控、终止进程 |
| 环境变量 | 管理系统环境变量 |
核心特性
- 跨平台支持 - Windows、macOS
- 异步执行 - 支持长时间运行的命令
- 输出捕获 - 实时捕获命令输出
- 安全控制 - 命令白名单和权限管理
核心功能分类
1. 命令执行
execute_command - 执行命令
- 执行单条系统命令
- 支持命令参数
- 返回执行结果和退出码
execute_script - 执行脚本
- 运行脚本文件
- 支持 bash、PowerShell、Python 等
- 传递脚本参数
execute_batch - 批量执行
- 顺序执行多条命令
- 支持条件执行
- 错误处理策略
2. 进程管理
start_process - 启动进程
- 后台启动程序
- 设置工作目录
- 配置环境变量
list_processes - 列出进程
- 查看运行中的进程
- 按名称/PID 筛选
- 显示资源使用
kill_process - 终止进程
- 按 PID 终止进程
- 按名称终止进程
- 强制终止选项
3. 环境变量
get_env - 获取环境变量
- 获取单个环境变量
- 获取所有环境变量
- 支持变量展开
set_env - 设置环境变量
- 设置临时环境变量
- 追加到 PATH
- 变量作用域控制
4. 工作目录
get_cwd - 获取当前目录
- 返回当前工作目录
change_dir - 切换目录
- 切换工作目录
- 支持相对/绝对路径
- 路径验证
MCP 工具列表
| 工具名 | 功能说明 |
|---|---|
execute_command | 执行系统命令 |
execute_script | 运行脚本文件 |
execute_batch | 批量执行命令 |
start_process | 启动后台进程 |
list_processes | 列出运行进程 |
kill_process | 终止进程 |
get_env | 获取环境变量 |
set_env | 设置环境变量 |
get_cwd | 获取当前目录 |
change_dir | 切换工作目录 |
使用场景
1. 开发辅助
- 编译代码项目
- 运行测试套件
- 启动开发服务器
2. 系统管理
- 执行维护脚本
- 监控系统进程
- 管理服务状态
3. 自动化任务
- 定时执行任务
- 批量文件处理
- 自动化部署
4. 环境配置
- 配置开发环境
- 管理 PATH 变量
- 设置项目环境
支持的 Shell
| 平台 | 默认 Shell | 可选 Shell |
|---|---|---|
| Windows | PowerShell | cmd, Git Bash |
| macOS | zsh | bash, sh |
命令执行选项
| 选项 | 说明 |
|---|---|
| cwd | 工作目录 |
| env | 环境变量 |
| timeout | 超时时间（毫秒） |
| shell | 使用的 Shell |
| encoding | 输出编码 |
安全特性
| 特性 | 说明 |
|---|---|
| 命令验证 | 检查命令合法性 |
| 路径限制 | 限制可访问的目录 |
| 权限控制 | 用户确认敏感操作 |
| 日志记录 | 记录所有执行的命令 |
优势特点
| 优势 | 说明 |
|---|---|
| ✅ 跨平台 | 统一的 API 支持多平台 |
| ✅ 实时输出 | 流式返回命令输出 |
| ✅ 异步执行 | 支持长时间运行命令 |
| ✅ 进程管理 | 完整的进程生命周期管理 |
| ✅ 安全控制 | 多层安全保护机制 |
注意
Terminal MCP 可以执行系统命令，请谨慎授权，避免执行不受信任的命令。
提示
Evol Terminal MCP 服务随 Evol 应用自动启动，无需手动配置。