SmartBW MCP
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 "Install 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 MCPretrieve 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.
SmartBW MCP
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
快速开始
1. 安装依赖
npm install -g @bitwarden/cli @bitwarden/mcp-server
pip install cryptography2. 配置
cp 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替代配置文件。
3. 启动守护进程
# 一键安装(含 systemd 服务或后台进程)
bash install.sh
# 或手动启动
python3 mcp_daemon.py4. 配置 MCP 客户端
在你的 MCP 客户端中添加:
{
"mcpServers": {
"smartbw": {
"command": "python3",
"args": ["/path/to/smartbw_mcp_server.py"]
}
}
}MCP 工具
工具 | 功能 |
| 一行获取 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 集成 | |
故障排查 | |
贡献指南 |
许可证
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables AI agents and automation scripts to securely interact with self-hosted Vaultwarden instances through the Bitwarden CLI, automatically managing vault sessions and providing tools to read, create, update, and delete secrets programmatically.Last updated291MIT
- AlicenseAqualityAmaintenanceMCP server for Vaultwarden/Bitwarden vault management. Enables AI agents to securely create, search, read, and update vault items via the official Bitwarden CLI, with safe-by-default redaction and support for both stdio and SSE transports.Last updated5326912MIT
- Flicense-qualityDmaintenanceEnables interaction with Bitwarden/Vaultwarden for password and secure note management, including creation, updating, deletion, and search of items and folders.Last updated2
- FlicenseBqualityDmaintenanceEnables secure retrieval of credentials from 1Password vaults for use by AI agents, supporting integration with browser automation for automated login.Last updated1
Related MCP Connectors
Shared long-term memory vault for AI agents with 20 MCP tools.
Encrypted secret store and rotation for autonomous agent credentials
User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ocoj/smartbw-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server