Provides tools for securely accessing and managing passwords, API keys, and other credentials stored in a Bitwarden vault, enabling AI agents to retrieve items via fuzzy search, exact lookup, or custom fields.
Provides tools for securely accessing and managing passwords, API keys, and other credentials stored in a Vaultwarden vault, enabling AI agents to retrieve items via fuzzy search, exact lookup, or custom fields.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SmartBW MCP retrieve the password for my email account"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vaultwarden/Bitwarden MCP 代理 — 让 AI 安全获取密码和 API Key
SmartBW MCP 是一个 MCP (Model Context Protocol) 工具服务器，让 AI Agent 通过标准 MCP 接口安全访问你的 Vaultwarden/Bitwarden 密码库。
smartbw_mcp_server.py ← MCP 工具层（8 个工具，AI 零门槛调用）
│
smart_search.py ← 智能搜索层（6 策略模糊搜索 + 索引加速）
│
mcp_raw.py ← 通信层（JSON-RPC + 熔断保护）
│
mcp_daemon.py ← 守护进程层（Unix Socket 常驻 + 自愈）
│
@bitwarden/mcp-server (Node.js) ← 协议层（Bitwarden 官方 MCP Server）
│
Vaultwarden 服务器 ← 数据层Related MCP server: Warden MCP Server
npm install -g @bitwarden/cli @bitwarden/mcp-server
pip install cryptographycp config.example.json ~/.config/bitwarden-mcp/config.json
# 编辑 config.json，填入你的 Vaultwarden 信息config.json 示例：
{
"bw_host": "https://your-vaultwarden.example.com",
"email": "user@example.com",
"master_password": "YourMasterPassword",
"client_id": "",
"client_secret": ""
}也可使用环境变量
BW_HOST、BW_EMAIL、BW_MASTER_PASSWORD替代配置文件。
# 一键安装（含 systemd 服务或后台进程）
bash install.sh
# 或手动启动
python3 mcp_daemon.py在你的 MCP 客户端中添加:
{
"mcpServers": {
"smartbw": {
"command": "python3",
"args": ["/path/to/smartbw_mcp_server.py"]
}
}
}工具 | 功能 |
| 一行获取 API Key（自动搜索 API 字段） |
| 获取密码 |
| 获取任意自定义字段 |
| 获取项目完整信息 |
| 模糊搜索（名称/用户名/自定义字段） |
| 列出所有项目 |
| 检查守护进程状态 |
| 强制刷新缓存（bw sync + 清理缓存） |
模糊搜索: 6 种评分策略，名称/用户名/自定义字段全覆盖，支持错别字容错
索引加速: 首次加载后构建名称索引，精确/前缀匹配 O(1)
熔断保护: 连续 5 次失败 → 30s 冷却，防止雪崩
线程安全: socket 收发原子锁 + 缓存双重检查锁
自愈: 守护进程每 60s 健康检查，session 过期自动恢复
凭证加密: 主密码自动 Fernet 加密存储，密钥绑定本机指纹
Unix Socket 权限 0o600（umask + chmod 双重保护）
密码/API Key 通过 Vaultwarden 管理，不落盘
配置文件中的敏感字段自动加密（!enc:v1:...）
加密密钥绑定本机，配置文件不可跨机器复制
配置项 | 环境变量 | 说明 |
Vaultwarden 地址 |
| 如 |
登录邮箱 |
| |
主密码 |
| 会自动加密存储 |
API Key |
| 推荐，兼容 2FA |
自定义配置目录 |
| 默认 |
MCP 超时 |
| 默认 30s |
模糊搜索阈值 |
| 默认 0.5 |
文档 | 说明 |
架构设计与通信路径 | |
依赖与版本要求 | |
Deep Code 集成 | |
OpenClaw 集成 | |
VS Code 集成（含安装踩坑记录） | |
故障排查 | |
贡献指南 |
MIT
This server cannot be deployed
Shared long-term memory vault for AI agents with 20 MCP tools.
MCP-first toolbox for agents: KV storage, auth, queue, and utility tools. Free in early access.
Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
