iflow-mcp_mcp-terminal

<div align="center"> # MCP Terminal MCP Terminal 是一个基于 MCP（Model Context Protocol）的终端控制服务器，专为与大型语言模型（LLM）和 AI 助手集成而设计。它提供了一个标准化的接口，使 AI 可以执行终端命令并获取输出结果。 <a href="https://glama.ai/mcp/servers/@sichang824/mcp-terminal"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@sichang824/mcp-terminal/badge" alt="Terminal MCP server" /> </a> [English](README.en.md) | 中文 </div> ## 演示视频 [](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](https://github.com/astral-sh/uv) 包管理工具 如果您还没有安装 uv，可以通过以下命令安装： ```bash # 在macOS上使用Homebrew brew install uv # 在其他平台上 pip install uv ``` ### 使用 uv 安装（推荐） 克隆仓库并使用 uv 安装依赖： ```bash # 克隆仓库 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 来简化常见操作： ```bash # 安装基本依赖 make setup # 安装iTerm2支持 make setup-iterm # 安装开发依赖 make setup-dev ``` ### 使用 Docker 安装 我们提供了 Docker 支持，可以快速部署 MCP Terminal 服务器： ```bash # 构建 Docker 镜像 docker build -t mcp-terminal . # 运行 Docker 容器（SSE模式，端口8000） docker run -p 8000:8000 mcp-…