buffTerm
简体中文 | English
面向 AI 的 SSH 工具与 MCP 服务器
An AI-first SSH tool and MCP server
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
简体中文 | English
面向 AI 的 SSH 工具与 MCP 服务器
An AI-first SSH tool and MCP server
Buff 加持的 SSH 工具 | 面向 AI 的 SSH 工具与 MCP 服务器,内置自研 AI Agent 编排层,接入任意 OpenAI 兼容协议的大模型。 An AI-oriented SSH tool and MCP server with a built-in self-developed AI Agent orchestration layer, compatible with integration of any large model supporting the OpenAI-compatible protocol.
buffTerm 是一款面向 AI 的 SSH 工具与 MCP 服务器,内置自研 AI Agent 编排层,接入任意 OpenAI 兼容协议的大模型(如 DeepSeek、Qwen、Kimi 等),用自然语言就能查询状态、排查问题、安装程序、开展运维工作。
并支持将多个主机同时暴露为 MCP 服务,提供给其他 AI 工具调用,安全级别由你把关。高危命令拦截、AI 操作审批与审计全程兜底;配置、凭据与审计数据只存本机,AI 对话与巡检内容会发送到你配置的模型平台。
🤖 Agent 编排层完全自研:核心工具调用循环(SSE 流式解析 → 工具执行 → 结果回填)由本项目手写实现,不依赖 LangChain / OpenAI Agents SDK / Vercel AI SDK 等框架——审批拦截、安全策略、审计留痕全部自己掌控。
请前往 GitHub Releases 下载最新安装包:
.dmg(Universal,同时支持 Apple Silicon 与 Intel).exe⚠️ macOS 版本目前未做 Apple 公证。凭据以 AES-256-GCM 加密存本机 SQLite,主密钥存系统钥匙串;未签名开发版首次访问钥匙串时可能弹一次系统授权提示,属 macOS 正常行为。
exec_command、read_file、list_dir、resource_usage、query_history(历史指标趋势,支持分钟 / 小时 / 天三档聚合粒度,AI 按分析目的自选)、update_task_plan(本地任务台账,免审批)russh / russh-sftp,不调用系统 ssh / sftp 命令~/.ssh、/etc/sudoers、/etc/shadow、cron、systemd、登录 shell 启动脚本等敏感路径需二次确认,每次保存写入操作审计rm -rf、mkfs、dd if=、systemctl stop、drop table、curl | sh 等,可删改、可一键恢复buffterm.log),用于排查问题;如包含敏感环境信息,请按需清理flowchart LR
UI["React + xterm.js<br/>终端 + 聊天面板"] -->|Commands / Channel / Events| BE["Rust 后端 (Tauri)"]
BE --> SM["Session Manager"]
BE --> AG["AI Agent Runtime"]
BE --> MCP["对外 MCP 服务<br/>Streamable HTTP + token"]
MCP --> MCPTOOL["工具层<br/>list_hosts / exec / 读文件 / 列目录 / 资源查询"]
SM --> SSH["交互会话<br/>russh shell channel + 二进制 Channel 输出"]
AG --> TOOL["工具层<br/>exec / 读文件 / 列目录 / 资源查询 / 历史趋势"]
TOOL --> RSH["russh 连接池<br/>协议级执行 / 连接复用 / 通道并发"]
BE --> SFTP["SFTP<br/>结构化目录 + 分块传输"]
SFTP --> RSH
BE --> INSP["AI 巡检<br/>只读命令 + 报告归档"]
INSP --> RSH
INSP --> PROV
AG --> PROV["模型适配层<br/>OpenAI 兼容协议"]
PROV --> DS["DeepSeek"]
PROV --> QW["通义 / Kimi / OpenAI"]
PROV --> OLL["本地 Ollama"]
BE --> DB[("SQLite<br/>配置 / 规则 / 审计 / 加密凭据 / 历史指标")]
BE --> KC[("系统钥匙串<br/>主密钥")]
BE --> MON["监控采集<br/>russh 连接池"]
npm install
npm run tauri dev
npm test # Vitest 前端单元测试
npm run build # TypeScript + Vite
cd src-tauri
cargo check
cargo test # Rust 单元/回归测试
cargo clippy
npm run tauri build
常用安装包快捷命令:
# macOS DMG
npm run build:mac
# Windows NSIS EXE
npm run build:win
产物位置:
src-tauri/target/release/bundle/dmg/
src-tauri/target/release/bundle/nsis/
DMG 需要在 macOS 上构建,EXE 建议在 Windows 上构建;打包前会先执行前端构建与 Rust 编译。未配置代码签名时仍可打包,但系统可能显示安全提示。
src/ 前端(React + xterm.js)
i18n/ 界面多语言(zh / en 字典、Provider、useT hook)
components/ 聊天面板 / 终端 / 文件编辑器 / 弹窗 / 下拉框等
assets/ buffTerm 界面与文档 logo
src-tauri/src/ Rust 后端
i18n.rs 后端多语言(语言状态、Tauri 命令、t())
agent.rs AI Agent 运行时(流式解析、工具循环、审批、审计)
agent/tools.rs Agent 工具定义与执行(系统提示词、工具 schema、exec/read_file/list_dir/resource_usage/query_history/update_task_plan)
agent/trend.rs 历史指标趋势分析(线性回归、分钟/小时/天粒度聚合、趋势文本格式化)
safety.rs 安全判定与脱敏(危险命令 / 只读检测 / 输出脱敏)
guard.rs 终端危险命令拦截(行缓冲状态机 + 规则判定 + 审批)
util.rs 通用工具函数(时间戳 / 截断 / shell 转义 / token)
session.rs SSH 交互会话(二进制 Channel 输出、退出/断线状态)
russh.rs 统一连接池(认证、known_hosts、并发通道、exec)
hosts.rs 主机配置
ai.rs AI 平台 / 模型 / 审核规则配置
credentials.rs 凭据加密(AES-256-GCM):主机密码 / 私钥口令 / API Key / MCP token / SMTP 密码
audit.rs 审计日志查询
monitor.rs 资源快照采集(CPU / 内存 / 磁盘 / 负载 / TOP 进程),写入历史指标表供 query_history 分析
alert.rs 通知配置(邮件 SMTP 配置与测试)
inspection.rs AI 只读巡检(含木马 / 挖矿风险采集)、报告生成与邮件投递
remediation.rs 一键整改(整改步骤生成、执行、重试、审计与邮件通知)
mcp.rs 对外 MCP 服务(HTTP + token + 权限模式)
sftp.rs SFTP 文件操作:结构化目录、分块传输与内置编辑器读写(原子写 / 敏感路径 / 审计)
update.rs GitHub Release 版本检查
db.rs SQLite(主机、AI 配置、规则、审计、巡检与整改、历史指标)
src-tauri/icons/ 桌面应用图标(PNG / ICNS / ICO)
.github/workflows/ GitHub Actions 自动构建与发布
docs/ 设计文档(密码加密 / AI Agent 权限 / MCP 服务 / 巡检整改 / 终端拦截)
Buff 加持的 SSH 工具 | 面向 AI 的 SSH 工具与 MCP 服务器,内置自研 AI Agent 编排层,接入任意 OpenAI 兼容协议的大模型。 An AI-oriented SSH tool and MCP server with a built-in self-developed AI Agent orchestration layer, compatible with in
總覽
Buff 加持的 SSH 工具 | 面向 AI 的 SSH 工具与 MCP 服务器,内置自研 AI Agent 编排层,接入任意 OpenAI 兼容协议的大模型。 An AI-oriented SSH tool and MCP server with a built-in self-developed AI Agent orchestration layer, compatible with integration of any large model supporting the OpenAI-compatible protocol.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Buff Term 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 Buff 加持的 SSH 工具 | 面向 AI 的 SSH 工具与 MCP 服务器,内置自研 AI Agent 编排层,接入任意 OpenAI 兼容协议的大模型。 An AI-oriented SSH tool and MCP server with a built-in self-developed AI Agent orchestration layer, compatible with integration of any large model supporting the OpenAI-compatible protocol.