Terminal MCP Server 是一个 Model Context Protocol（MCP）服务器，旨在让 AI 智能体能够与 TUI/CLI 终端应用程序进行交互。它通过结构化的“终端状态树”（Terminal State Tree，TST）表示终端界面，并具备元素检测能力，其定位类似于“终端版的 Playwright”。该服务器可与任何支持 Model Context Protocol 的 AI 助手配合使用。
主要能力：
- 通过结构化终端状态树（TST）表示终端界面，支持元素检测。
- 让 AI 智能体能够创建终端会话、对终端进行快照、发送按键（如方向键）、输入命令并回车等操作。
- 支持可见终端窗口（xterm）与无头（headless）两种运行模式。
安装方式：
- 通过 npm 安装（推荐）。
- 通过 GitHub Releases 下载预编译二进制文件。
- 从源码构建。
使用方式（配置到各类 MCP 客户端）：
- Claude：添加到 ~/.claude.json（macOS/Linux）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。
- Codex：添加到 ~/.codex/config.toml。
- VS Code / GitHub Copilot：VS Code 1.101+ 支持 MCP，添加到 settings.json。
- Cursor：添加到 ~/.cursor/mcp.json 或项目中的 .cursor/mcp.json。
- Windsurf：添加到 ~/.codeium/windsurf/mcp_config.json。
- Zed：添加到 Zed 设置（Preferences → Settings）。
- Cline（VS Code 扩展）：点击 MCP Servers 图标 → Configure → Advanced MCP Settings，然后添加配置。
- Bedrock：添加到 Bedrock agent 的 MCP 配置。
- 其他 MCP 客户端：使用 Args: ["mcp-server-terminal"] 配置；若直接使用二进制文件，则 Command: terminal-mcp。
典型使用示例（向 AI 智能体发出指令）：
- “Create a terminal session running htop”
- “Take a snapshot of the terminal”
- “Press the down arrow key”
- “Type 'ls -la' and press Enter”
无头模式： 默认情况下，会话会启动一个可见的终端窗口（xterm）。如需无头运行，可在 MCP 配置中进行相应设置。
X11 设置（Linux/WSL）： 可视模式需要 X11。需在 MCP 配置中添加 DISPLAY 环境变量。
日志： 可通过设置 RUST_LOG 环境变量控制日志级别，可选级别包括 error、warn、info、debug、trace。日志输出到 stderr（stdout 保留给 MCP 协议）。
平台支持： Windows 用户建议使用 WSL 以获得完整功能（包括可视模式）。
限制与注意事项：
- 可视模式在 Linux/WSL 下需要 X11 环境。
- Windows 下需借助 WSL 才能使用完整功能。
- 关于收费、价格、具体性能效果等信息，资料中暂未提供。
