内容
<div align="center">
<img src="brand/logo/agentpass-terracotta.svg" alt="AgentPass" width="360" />
### 您的服务器密钥，由您的编码代理保管。
[](LICENSE)
</div>
---
**AgentPass** 是一个MCP服务器，它记住如何登录到您的机器，因此您可以告诉Claude Code *"在我的VPS上重启nginx"*，它就会执行 — 而无需将您的根密码存储在聊天记录、shell历史记录或配置文件中。
一个进程。没有守护进程，没有数据库，没有UI。
```
您 → "添加我的VPS，23.x.x.x，root，<密码>" → add_host
您 → "检查我的VPS磁盘" → run
↓
~/.agentpass/hosts.json AES-256-GCM
~/.agentpass/master.key 0600
```
秘密仅在登录期间被解密，写入一个0700目录，之后会被清除，并交给系统`ssh`客户端 — 永远不会交给代理，也不会进入对话。`get_secret`存在于您真正需要纯文本的时候；它会说明这一点，并被记录。
## 安装
需要[Node.js](https://nodejs.org) 22+ 和一个`ssh`客户端（在Windows上：Git Bash，每个Git for Windows安装都附带）。
```bash
git clone https://github.com/sooua/AgentPass.git
cd AgentPass && pnpm install && pnpm build
claude mcp add agentpass -- node "$PWD/dist/index.js"
```
这就是整个设置过程。无需创建令牌或启动服务。
详细的操作指南、实际场景和故障排除表：
**[使用说明](USAGE.zh-CN.md)**。
## 使用
与您的代理对话：
> 记住我的VPS：23.238.1.51，用户root，密码…
> 我的VPS的运行时间是多少？
> 给我一个ssh命令，让我可以自己查看VPS。
## 工具
| 工具 | 功能 |
|------|--------------|
| `add_host` | 存储机器 + 密码或私钥。静止加密。 |
| `list_hosts` | 您存储了什么。永远不会包含秘密。 |
| `update_host` | 在无需重新输入其他信息的情况下更改名称、地址、端口或秘密。 |
| `remove_host` | 忘记一个。 |
| `run` | 登录，运行一个命令，返回输出，擦除登录文件。 |
| `ssh_access` | 返回一个现成的`ssh`命令，用于交互式工作。 |
| `get_secret` | 纯文本，当您真正需要时。已记录，附带原因。 |
主机按您给它们的名字寻址，不区分大小写 — `my vps`找到`My VPS`。
## 磁盘上存储的内容
```
~/.agentpass/
hosts.json 您的机器；每个秘密都使用AES-256-GCM加密
master.key 32个随机字节，0600（+ Windows ACL）
audit.jsonl 每个操作一行，秘密永远不会出现在其中
access/ 实时登录；每个登录的TTL到期、退出后和下次启动时都会清除
```
没有任何内容离开您的机器。没有帐户，没有遥测数据，除了您请求的SSH连接外，没有网络调用。
## 诚实的限制
- **代理可以运行任何您能运行的命令。** `run`是一个shell命令，可以在您的服务器上运行。这就是目的，也是风险 — 审计日志会告诉您它做了什么，而您的代理自己的工具审批门户会在执行前阻止它。
- **任何能读取您的用户帐户的人都能读取保险库。** 主密钥与数据一起存放在0600权限下，就像`~/.ssh/id_rsa`一样。这可以防止秘密通过聊天记录泄露，而不是防止已经以您的身份登录的人访问。
- **`get_secret`会将纯文本放入对话中。** 一旦放入，就会在模型的上下文和您的聊天记录中。优先使用`run`和`ssh_access`。
- **密码身份验证需要OpenSSH 8.4+** （用于`SSH_ASKPASS_REQUIRE`）和在Windows上使用Git Bash — 自带的`ssh.exe`无法启动askpass助手。
## 历史
1.x版本是一个更大的东西：一个本地守护进程，一个HTTP API，一个Tauri桌面应用程序，作用域代理令牌，具有职责分离的审批工作流，轮换策略和端到端加密同步。所有这些都有效；但对于拥有几台服务器的单个用户来说，几乎没有一个功能是必要的。它被保存在git历史记录中和[v1.0.3版本](https://github.com/sooua/AgentPass/releases/tag/v1.0.3)中，如果您需要一个多用户保险库。
## 许可证
[MIT](LICENSE) © 2026 sooua
