帕斯曼
AI代理的安全凭证代理
   ](https://github.com/ahmadzein/passman/releases/tag/v0.0.3)
**让AI代理 *使用* 你的证件从来没有 *看见* 他们。**
SSH连接到服务器。查询数据库。调用API。发送电子邮件。 所有这些都不会向LLM暴露任何密码、密钥或令牌。
______________________________________________________________________
问题
目前处理凭据的每个MCP服务器 向人工智能泄露秘密 或是 仅限于单一协议。没有统一、安全、多协议的凭证代理。
解决方案
帕斯曼是一个 加密本地保险库 + 凭证代理 它位于AI代理和您的基础设施之间。AI按名称引用凭据。Passman在服务器端注入它们。人工智能会得到结果——从每个响应中清除秘密。
AI Agent Passman Your Infrastructure
┌─────────┐ ┌──────────┐ ┌─────────────────────┐
│ "Query │ credential │ Decrypt │ inject auth │ │
│ prod-db │ ────by ID───> │ + Proxy │ ────────────> │ PostgreSQL / SSH │
│ for │ │ + Scrub │ │ API / SMTP Server │
│ users" │ **AI可读参考：** 看 [`skill.md`](skill.md) 为AI代理优化的完整工具参考。
### 配置您的AI客户端
Claude Code
claude mcp add --transport stdio passman -- ~/.local/bin/passman-mcp-server
或添加到 `.mcp.json`:
{ "mcpServers": { "passman": { "command": "~/.local/bin/passman-mcp-server", "args": [], "transport": "stdio" } } }
Cursor
在光标设置>MCP服务器中：
{ "mcpServers": { "passman": { "command": "~/.local/bin/passman-mcp-server" } } }
VS Code (Copilot)
在 `.vscode/mcp.json`:
{ "servers": { "passman": { "type": "stdio", "command": "~/.local/bin/passman-mcp-server" } } }
Claude Desktop
在 `claude_desktop_config.json`:
{ "mcpServers": { "passman": { "command": "~/.local/bin/passman-mcp-server", "args": [] } } }
Windsurf
在MCP配置中：
{ "mcpServers": { "passman": { "command": "~/.local/bin/passman-mcp-server", "args": [] } } }
### 用它
You: "Unlock my vault" AI: vault_unlock({password: "..."}) → Vault unlocked. 5 credentials.
You: "List my credentials" AI: credential_list() → [{name: "GitHub Token", kind: "api_token"}, ...]
You: "Use my GitHub token to check my repos" AI: http_request({credential_id: "abc-123", method: "GET", url: "https://api.github.com/user/repos"}) → {status: 200, body: [{name: "my-project", ...}]} // Token was injected server-side. AI never saw it.
You: "SSH into prod and check nginx status" AI: ssh_exec({credential_id: "def-456", command: "systemctl status nginx"}) → {exit_code: 0, stdout: "● nginx.service - active (running)..."} // Password/key never exposed.
______________________________________________________________________
## 14 MCP工具
|类别|工具|描述|
|----------|------|-------------|
| **金库** | `vault_unlock` |使用主密码解锁保险库|
| | `vault_lock` |锁保险库，记忆中的零键|
| | `vault_status` |检查保险库状态|
| **发现** | `credential_list` |列出凭据（可筛选）|
| | `credential_search` |按名称、标签、注释搜索|
| | `credential_info` |获取凭证元数据（无秘密）|
| **存储** | `credential_store` |存储新凭据|
| | `credential_delete` |删除凭据|
| **代理** | `http_request` |经过身份验证的HTTP请求|
| | `ssh_exec` |SSH命令执行|
| | `sql_query` |数据库查询（Postgres/MySQL/SQLite）|
| | `send_email` |通过SMTP发送电子邮件|
| **审计** | `audit_log` |查看使用历史记录|
______________________________________________________________________
## 建筑
passman/ ├── crates/ │ ├── passman-types/ # Shared types, enums, traits │ ├── passman-vault/ # Encrypted vault: crypto, CRUD, audit │ ├── passman-proxy/ # Protocol proxies + output sanitizer │ └── passman-mcp/ # MCP server (rmcp), 14 tools, policy engine ├── bins/ │ └── passman-mcp-server/ # Standalone MCP binary (stdio transport) ├── app/ # Tauri v2 + React desktop app └── skill.md # AI-readable feature reference
### 技术栈
|组件|技术|
|-----------|-----------|
|语言| Rust|
|MCP SDK | rmcp 0.15+|
|加密|aes gcm+argon2|
|HTTP代理| reqwest|
|SSH代理| russh|
|SQL代理|sqlx（任何驱动程序）|
|SMTP代理|lettre|
|桌面GUI | Tauri v2+React|
|内存安全|清零+保密|
______________________________________________________________________
## 桌面图形用户界面
一款功能齐全的桌面应用程序，用于可视化凭证管理，使用Tauri v2+React构建。与MCP服务器共享同一保管库。
### 下载
下载自 :
|平台|格式|
|----------|---------|
|macOS（苹果硅）| `.dmg` |
|macOS（英特尔）| `.dmg` |
|窗户| `.exe` 安装程序， `.msi` |
|Linux| `.AppImage`, `.deb`, `.rpm` |
> **macOS：** 安装后，运行此命令一次以绕过Gatekeeper（该应用程序未使用Apple Developer证书签名）：
>
> ```bash
> xattr -cr /Applications/Passman.app
> ```
或者通过CLI安装程序进行安装：
curl -fsSL https://raw.githubusercontent.com/ahmadzein/passman/main/install.sh | GUI=1 bash
### 从源代码构建
cd app npm install npm run tauri dev # Development npm run tauri build # Production build
### 屏幕
解锁| Vault浏览器|凭据编辑器|策略编辑器|审核日志|设置
> **注：** GUI和MCP服务器共享同一个保险库 `~/.passman/vault.json`一个的变化在另一个中立即可见。
______________________________________________________________________
## 运行测试
cargo test --workspace # All unit tests
______________________________________________________________________
## 文件位置
|文件|目的|
|------|---------|
| `~/.passman/vault.json` |加密凭证保管库|
| `~/.passman/audit.jsonl` |仅附加审核日志|
______________________________________________________________________
## 为什么是帕斯曼？
||Passman|Janee|mcp秘密库|1密码 `op run` |谷歌工具箱|
|---|---|---|---|---|---|
| **协议** |HTTP+SSH+SQL+SMTP|仅限HTTP |HTTP（仅限GET/POST）|仅限环境变量|仅限SQL|
| **凭证代理** |完整代理|HTTP代理|HTTP代理人|Env注入|SQL代理|
| **加密保管库** |AES-256-GCM | AES-256-GCSM |仅限环境变量|1密码库|配置文件|
| **输出净化** |6种编码|基本（8+个字符）|基本|stdout掩码|无|
| **自托管** |是（本地优先）|是|是|需要1Password |谷歌云偏见|
| **桌面图形用户界面** |Tauri+React |否|否|1密码应用程序|否|
| **开源** |麻省理工学院| MIT |专有| Apache 2.0|
| **策略引擎** |按凭据规则|按功能|按秘密域|无|数据库权限|
| **成本** |免费|免费|免费|3-8美元/月|免费|
______________________________________________________________________
## 贡献
欢迎投稿！请先打开一个问题，讨论您想更改的内容。
Development setup
git clone https://github.com/ahmadzein/passman.git cd passman cargo build cargo test --workspace
______________________________________________________________________
## 许可证
[麻省理工学院](LICENSE) -用它，叉它，在它上面建造。
______________________________________________________________________
**用Rust构建。通过设计确保安全。永远开源。**