TerminalSAFE

MCP Terminal 是一个基于 MCP(Model Context Protocol)的终端控制服务器,专为与大型语言模型(LLM)和 AI 助手集成而设计。它提供了一个标准化的接口,使 AI 可以执行终端命令并获取输出结果。

English | 中文

演示视频

[](https://player.bilibili.com/player.html?isOutside=true&aid=114488023981820&bvid=BV1agEuzGE1X&cid=29904276803&p=1)

特性

• 使用官方 MCP SDK 实现
• 支持多种终端控制器:
• iTerm2 控制器:在 macOS 上使用 iTerm2 的 Python API 提供高级控制
• AppleScript 控制器:在 macOS 上使用 AppleScript 控制 Terminal 应用
• Subprocess 控制器:在所有平台上通用的终端控制方式
• 支持多种服务器模式:
• STDIO 模式:通过标准输入/输出与客户端通信
• SSE 模式:通过 Server-Sent Events 提供 HTTP API
• 提供多种工具:
• 终端工具:执行命令并获取输出
• 文件工具:进行文件操作(读写、追加、插入)
• 自动检测最佳终端控制器
• 与 Claude Desktop 无缝集成
• 支持 Docker 部署

安装

先决条件

• Python 3.8+
• uv 包管理工具

如果您还没有安装 uv,可以通过以下命令安装:

# 在macOS上使用Homebrew
brew install uv

# 在其他平台上
pip install uv

使用 uv 安装(推荐)

克隆仓库并使用 uv 安装依赖:

# 克隆仓库
git clone https://github.com/yourusername/mcp-terminal.git
cd mcp-terminal

# 创建虚拟环境并安装基本依赖
uv venv
source .venv/bin/activate  # 在Windows上使用 .venv\Scripts\activate
uv pip install -e .

# 如果需要iTerm2支持 (仅限macOS)
uv pip install -e ".[iterm]"

# 如果需要开发工具(测试、代码格式化等)
uv pip install -e ".[dev]"

注意:如需使用 iTerm2 控制器,必须在 iTerm2 设置中启用 Python API。 打开 iTerm2,依次进入 Preferences → General → Magic,勾选 Enable Python API 选项,如下图所示:

使用 Makefile 安装

我们提供了 Makefile 来简化常见操作:

# 安装基本依赖
make setup

# 安装iTerm2支持
make setup-iterm

# 安装开发依赖
make setup-dev

使用 Docker 安装

我们提供了 Docker 支持,可以快速部署 MCP Terminal 服务器:

# 构建 Docker 镜像
docker build -t mcp-terminal .

# 运行 Docker 容器(SSE模式,端口8000)
docker run -p 8000:8000 mcp-t