使用说明
mcp ssh管理器
mcp-ssh-manager 是集成管理网络中SSH连接的GUI集线器和MCP服务器。
该工具是基于纯Rust实现的便携式SSH客户端 mcp-ssh 是成对的存在这两个都在一起，AI时代的安全远程操作才结束。 为了便于开发，资料库是分开的，但这些都是作为一个生态系统的两轮设计的。
🛡️ 设计思想：AI时代的零信任SSH
当AI代理与SSH合作时，传统的密码认证具有重大风险。为了解决以下问题，本项目提倡“强制无密码硬件”。
- AI的记忆风险的回避：一次传递给AI的ID/密码不仅会保留在交互历史记录中，而且很难从模型的存储（上下文）中完全清除。这是一个永久的信息泄露风险。
- 隐藏密码信息：贯彻“仅在初次设置时输入密码”。通过MCP化的SSH，AI代理不显示任何密码和关键认证信息，只使用安全抽象化的“别名”完成操作。
- TPM密钥保护：生成的私钥在设备中 TPM（可信平台模块） 中所述修改相应参数的值。这意味着AI代理和恶意软件可以在物理密钥文件（
.ssh/id_rsa等），防止直接触摸或偷盗。 - 克服Windows ACL问题：在Windows的OpenSSH环境中，由于频繁的密码变更和密钥文件的访问权限（ACL）设置错误，容易发生认证错误。本工具的“联机向导”可自动执行这些复杂的权限设置，并帮助您过渡到稳定的密钥身份验证。
不仅仅是便利性的提高**“不告诉AI秘密”** 构建零信任环境是本工具的真正目的。
🌟 核心功能：硬件身份
本工具不仅严格管理“谁”连接，还严格管理“从哪个设备”连接。
- mcp-ssh集成管理: mcp-ssh 使用GUI集中管理所使用的连接目标和凭据。
- TPM/Secure Enclave连携：在设备的安全芯片内生成并保持机密密钥。钥匙的复印和带出是不可能的。
- 添加向导：在首次设置时诊断设备的运行状况，并将与硬件相关的标识符安全注册到远程服务器。
- 零信任访问：建议您取消传统密码验证，并始终配置设备的硬件验证。
1.主接口（标签配置）
1.1. 🌐 接続先 (Connections)
- 显示状态：显示在计算机左侧的图标（🟢 联机/🔴 脱机）了解运行状况。
- 快速操作:
- ✏️ 编集：更改计算机规格和监视端口。
- ⚡ 世界野生动物基金会：通过Wake-On-LAN远程启动计算机。
- 💻 接続：标准
ssh通过命令启动终端。
- 高级搜索：立即按用途或主机名过滤。
1.2. 👥 帐户
- 安全注册和管理用于SSH连接的凭据（用户名、密码、私钥）。
1.3. 📜 日志
- 所有工具运行（
ssh_exec等）的履历、命令、结束代码、时间戳。
1.4. 🛠️ 工具
- 自动备份：每天自动生成SQLite数据库备份一次。
- 备份轮换：保留最近7天的时间，旧的将自动删除。
- 手动备份：可以在任何时间立即创建备份。
2.高级功能
2.1.死活监视（Advanced Monitoring）
- ICMP Ping：即使TCP端口关闭，也可以自动进行Ping的沟通确认。
- 自定义端口：除了SSH（22）以外，还可以通过HTTP（80/443）等任意端口进行监视。
2.2.自动维护
- 在应用程序启动期间，将定期在后台进行计算机运行确认和数据库备份。
4.命令行（CLI）模式
本应用程序通过传递命令行参数，可以在没有GUI的情况下进行操作。
4.1.查看计算机列表
./mcp-ssh-manager list
4.2.添加计算机
./mcp-ssh-manager add <名前> <IP/ホスト名> --purpose "利用目的" --owner "personal" --os "linux"
4.3.执行备份
在默认备份位置创建：
./mcp-ssh-manager backup
指定路径：
./mcp-ssh-manager backup [出力パス]
4.4.无头MCP服务器模式
不启动GUI，通过标准输入输出（stdio）作为MCP服务器运行。
./mcp-ssh-manager mcp
5.设置和路径
- 数据库:
~/Library/Application Support/com.veltrea.mcp-ssh-manager/manager.db - 备份目标：在该目录中
backups/文件夹。
