AT Terminal MCP 中文文档

更适合ai IDE的终端插件

文档入口

飞书文档

• Features
• Usage Guide
• Chinese documentation

Agent Skills

项目提供符合 Agent Skills 规范的可安装技能。Skills 不复制进 VSIX，用户可以按需安装到 Codex、Claude Code、Cursor、GitHub Copilot 等兼容 Agent，避免在每次对话中重复发送完整运维提示词。

使用 skills CLI 从 GitHub 按需安装：

npx skills add xwamt/At-Terminal --skill at-terminal-mcp
npx skills add xwamt/At-Terminal --skill writing-ops-documents

Agent 提示词只需指向相应技能：

Use $at-terminal-mcp for SSH servers, remote commands, SFTP, deployments, incidents, and workspace-to-server troubleshooting.
Use $writing-ops-documents for operation records, troubleshooting reports, deployment documents, inspection reports, RCA, and other operations documentation.

当两个技能同时适用时，先使用 $at-terminal-mcp 收集并验证远程证据，再使用 $writing-ops-documents 将事实、推断、操作、验证结果和遗留风险整理为规范文档。

两种构建版本

AT Terminal 是一款面向 VS Code 兼容 IDE 的 SSH 终端与 SFTP 远程文件工作区扩展。它通过标准 SSH/SFTP 协议直接连接远程服务器，不需要在服务器上安装 VS Code Server、Remote Agent 或任何额外服务端组件。

AT Terminal MCP 是 AT Terminal 的 Agent 增强版本。它保留完整的 SSH 终端、SFTP 文件管理和远程文件本地编辑能力，同时通过共享 AT Series MCP hub，让 Kiro、Cursor、Continue 等支持 MCP 的 AI IDE 可以通过受控工具读取远程文件、执行非交互命令，并协助完成远程脚本和配置文件维护。

MCP 客户端只配置一条 AT Series 入口（node ~/.at-series/mcp/hub.js），不再使用 per-plugin mcp-server.js 或 VS Code languageModelTools。安装命令会写入该入口并迁移掉旧的 AT Terminal MCP 条目。架构说明见 ADR-005。

项目提供两个面向不同用户的构建版本。

如果只需要在 IDE 内使用 SSH/SFTP，安装基础版 AT Terminal 即可。如果用户希望 GitHub Copilot Chat、Kiro、Cursor、Continue 等 Agent 调用远程命令或远程文件工具，应安装 AT Terminal MCP。

后台连接授权（0.2.17）

为适配当前 Agent 窗口形态 的 AI IDE（例如 Codex、Cursor Agent、Kiro 等：对话在独立 Agent 侧，IDE 更多承担扩展宿主角色），AT Terminal MCP 增加了按服务器维度的 「允许后台连接（Allow background connections）」 授权。

启用后，Agent 可通过 MCP 在后台发现并连接已授权的 SSH 服务器、执行受控远程命令，而 IDE 本身可以作为服务基座与资产管理窗口——负责保存服务器资产、凭据、信任策略与 MCP 桥接，不必始终打开交互式终端会话。

使用说明：

1. 在服务器编辑页将 Trust agent remote commands 设为 Limited trust 或 Full trust，再勾选其子项 Allow background connections。
2. 未授权后台连接的服务器不会出现在 list_ssh_servers 中；若前端已打开该服务器终端连接，run_remote_command 仍可执行。仅在前端未连接时，才要求勾选后台连接。
3. 旧配置默认关闭后台连接，升级后需按服务器显式开启。

MCP Hub 拆分（0.3.0）

从 0.3.0 起，共享 MCP Hub 已从本插件仓库拆分为独立开源包 @at-series/mcp-hub：

• 职责边界：Hub 负责 AT Series 入口聚合、安装器与协议类型；本仓库只保留 AT Terminal 扩展、Bridge 发布与按需同步 hub.js。
• 依赖方式：通过 npm 公开 registry 声明依赖（当前 ^0.1.1）。执行 npm install 即可拉取，不再需要克隆 Hub 仓库，也不再使用 file: 本地链接。
• 打包行为：npm run build:mcp / package:mcp 会把已发布 Hub 中的运行时复制为 dist/hub.js，并写入 dist/hub-version.json 供选举同步使用。

架构说明见 ADR-004 与 ADR-005。

命令信任与智能放行策略（0.3.3）

从 0.3.3 起，远程命令确认网关（Remote Command Policy）升级为三档信任 + 精细化黑名单：

• 三档信任下拉：不信任（每条远程命令都弹窗，不显示后台连接）、有限信任（黑名单策略，显示后台连接且切换时默认不勾）、完全信任（远程命令与 SFTP 写入均不弹窗，显示后台连接且切换时默认勾选）。已有「信任」勾选的服务器读成有限信任。
• 引号感知词法：引号内的 |、>、\ 不再当操作符；grep -E 'error|fail'、awk 'NR>1'、docker ps、iptables -L 在有限信任下免确认；sed -i、docker exec、sudo 等仍弹窗。
• 智能安全重定向放行：对静默/错误输出重定向（如 2>/dev/null、>/dev/null 2>&1、&>/dev/null、1>&2 等）智能识别并自动放行，不再误触发确认弹窗；向实际文件写数据的重定向（如 > /etc/hosts、>> file）依然严格弹窗。
• 系统标准二进制路径支持：支持 /bin/ls、/usr/bin/cat、/usr/bin/uptime 等标准系统路径调用的只读命令直接放行；对自定义脚本路径（./deploy.sh、/tmp/payload）保持确认。
• 复合语句与控制流关键字识别：对 for ...; do ...; done、while ...; do ...; done、if ...; then ...; fi 等 Shell 循环与分支命令自动跳过 do / then 等控制流关键字，内部只读命令安全放行，包含危险操作（do rm ...）精准拦截。
• 编辑服务器密码体验优化：修复多语言环境下编辑已有服务器时密码被强制要求重填的问题，留空保存即可安全保留已有凭据。

构建产物

请先安装 Node.js 和 npm。建议使用较新的 Node.js LTS 版本。进入项目根目录后安装依赖：

#安装依赖
npm install
#打包前可以先执行类型检查和测试，确认当前代码状态正常：
npm run typecheck
npm test
#打包基础版插件
npm run package:base
#打包 MCP 版插件
npm run package:mcp

本地安装

打包成功后，项目根目录会生成类似下面的文件：

at-terminal-mcp-0.3.3.vsix

生成 .vsix 后，可以在 VS Code / Cursor / Kiro 等兼容 VS Code 插件的 IDE 中通过“从 VSIX 安装”安装，也可以使用命令行安装

code --install-extension at-terminal-mcp-0.3.3.vsix
#如果安装基础版，则把文件名替换为实际生成的 at-terminal-*.vsix。

特色功能

生态适配

• 依托VS CODE插件生态，适配所有VS CODE系列IDE，包括cursor、kiro、Antigravity、Qcode、Trae等主流ai coding IDE。

• 不提供原生agent（因为你再怎么做也比不过大厂）仅提供标准MCP接口，agent能通过接口调用工具。标准mcp接口，也可以被codex和claud code调用

• 厌倦了Terminal千篇一律的ui风格，插件能跟随IDE的主题更换UI风格

文件操作

• 查看：在ide里直接查看服务器上文件，实现基于不同文件格式的渲染效果

• 编辑：在ide内编辑文件，使用agent直接写脚本或配置

agent

可以基于各ai ide内置agent，调用mcp接口实现下列操作

• 命令执行：agent直接在服务器上执行命令，联合代码与运行情况一同排查

• 文件上传：结合文件上传功能，让agent直接帮你部署服务

• 文件编辑：直接修改服务配置文件

功能总览