1Password MCP Server

社区

为 AI 助手打开一扇通往 1Password 的锁门，而不是把密码堆进聊天记录

分类: 开发工具第 5 / 438
Stars: ★ 21 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 18 天前
工具数: 15

75FMRS · B

一个设计成熟、安全意识突出的社区版 1Password MCP 服务器。15 个工具覆盖凭据全生命周期，op_run + op:// 引用的默认安全路径能有效避免明文密钥进入模型对话，密码读取默认仅返回元数据也是加分项。需要注意的是它并非 1Password 官方产品，且 MCP 传输层对密钥并非端到端加密，因此只适合自动化凭据管理，不适合处理个人高敏感信息。适合开发者与 SRE 在专用自动化保险库中使用。

最强项 · 文档质量 18/20 最弱项 · 可靠性 12/20

可靠性

12/20

安全与权限

16/20

维护活跃度

14/20

文档质量

18/20

安装易用性

15/20

查看各项评分依据

可靠性 12/20: 项目使用MCP SDK v2，有明确的协议协商支持2026-07-28版本，同时保持与旧版客户端的兼容性。代码结构清晰，有完整的工具、提示和资源实现。但缺乏对错误处理和边界情况的深入测试证据，因此得分低于满分。
安全与权限 16/20: 项目采用安全优先的设计，默认不返回敏感数据，需要显式设置reveal: true才能获取密码等敏感信息。支持op_run功能，可以在子进程中注入环境变量而不在模型输出中暴露明文。支持macOS Keychain集成和允许列表配置。但MCP协议本身在传输中不加密，存在一定风险。
维护活跃度 14/20: 项目有活跃的CI/CD流程，版本更新频繁，最近发布了4.0.2版本。使用Apache 2.0许可证，有明确的贡献指南。但依赖项更新情况不明，issue响应时间无法从静态代码中判断。
文档质量 18/20: 文档非常全面，包含详细的安装指南、配置选项、工具说明和使用示例。特别强调了安全最佳实践，包括如何处理敏感信息和最小权限原则。提供了针对不同客户端的配置示例，如Claude Desktop、VS Code、OpenAI Codex等。
安装易用性 15/20: 安装过程简单，使用npm包管理器，支持通过环境变量或CLI参数配置。提供了针对不同平台的配置指南，特别是macOS的Keychain集成。配置示例清晰，易于理解和使用。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络修改第三方账户数据

适合谁

需要管理 CI 令牌、机器人账号等自动化凭据的个人与团队
希望在模型对话中避免明文密钥的安全敏感用户
使用 Claude Desktop、Cursor、VS Code Copilot、OpenAI Codex 等 MCP 客户端的开发者与 SRE

不适合谁

存储银行账户、个人主登录、恢复码等高敏感凭据
不愿意将任何揭示内容发送给 AI 提供商的场景
需要端到端加密传输密钥的工作流
没有 Node.js 20+ 运行环境的用户

所需权限

需要 1Password 服务账号令牌（或 macOS 钥匙串中的令牌）
服务账号需被授权访问目标保险库
op_run 可在本地机器执行任意命令（含 cwd、shell、timeout、stdin 参数）
item_delete 可永久删除条目，不可恢复

风险与副作用

向模型揭示的任何内容可能被发送到 AI 提供商并按其政策留存
MCP 流程中密钥以明文存在，并非端到端加密；仅 1Password 存储时加密
服务账号令牌等同主密钥，泄露需立即轮换
item_delete 永久删除且不可撤销
op_run 允许执行本地命令，需配合保险库白名单与最小权限原则

安装接入

准备工作

运行环境：Node.js 20+

OP_SERVICE_ACCOUNT_TOKEN 必填密钥 1Password 服务账户令牌，在 1Password 网页端 Developer → Service Accounts 创建后一次性复制。

其他可选配置项（7 个）

OP_KEYCHAIN_SERVICE 可选仅 macOS：存放服务账户令牌的 Keychain 服务名，用于免去在配置文件中放令牌。

OP_KEYCHAIN_ACCOUNT 可选仅 macOS：可选的 Keychain 账户名，用于缩小令牌查找范围。

OP_MCP_ALLOWED_VAULTS 可选可选的逗号分隔密钥库名称或 ID，限制 op_run 和 op_check_ref 可解析的密钥库。

OP_INTEGRATION_NAME 可选可选，报告给 1Password SDK 的集成名称，默认 1password-mcp。

OP_INTEGRATION_VERSION 可选可选，报告给 1Password SDK 的集成版本。

MCP_LOG_LEVEL 可选日志级别：debug、info、warn 或 error，默认 info。

MCP_DEBUG 可选设置后强制开启调试日志。

安装 Node.js 20 或更新版本
在 1Password 网页端进入 Developer → Service Accounts，创建仅授权自动化保险库的服务账号并复制令牌
在 MCP 配置中添加：{"mcpServers":{"1password":{"command":"npx","args":["-y","@takescake/1password-mcp"],"env":{"OP_SERVICE_ACCOUNT_TOKEN":"YOUR_SERVICE_ACCOUNT_TOKEN"}}}}
重启应用后即可用自然语言操作；macOS 可改用 OP_KEYCHAIN_SERVICE 从钥匙串读取令牌，避免令牌写入配置文件；可通过 OP_MCP_ALLOWED_VAULTS 限制 op_run / op_check_ref 可解析的保险库白名单。

claude_desktop_config.json

{"mcpServers":{"1password":{"command":"npx","args":["-y","@takescake/1password-mcp"],"env":{"OP_SERVICE_ACCOUNT_TOKEN":"YOUR_SERVICE_ACCOUNT_TOKEN"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "1password": {
      "command": "npx",
      "args": [
        "-y",
        "@takescake/1password-mcp"
      ],
      "env": {
        "OP_SERVICE_ACCOUNT_TOKEN": "YOUR_SERVICE_ACCOUNT_TOKEN"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add 1password -e OP_SERVICE_ACCOUNT_TOKEN=YOUR_SERVICE_ACCOUNT_TOKEN -- npx -y @takescake/1password-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启客户端后询问「列出我的 1Password 密钥库」，若 vault_list 工具可用并返回密钥库列表即连接成功。

常见排障

确认已安装 Node.js 20 或更新版本
检查 OP_SERVICE_ACCOUNT_TOKEN 是否正确设置且未过期
macOS 上若未设令牌环境变量，确认 OP_KEYCHAIN_SERVICE（及可选 OP_KEYCHAIN_ACCOUNT）配置正确
若 op:// 引用解析被拒，检查 OP_MCP_ALLOWED_VAULTS 白名单是否包含目标保险库名称或 ID
确认服务账号已被授予访问相关保险库的权限
调整 MCP_LOG_LEVEL 为 debug 获取更多日志

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 1Password 密钥库
在 Automation 密钥库里搜索名字包含 staging 的条目
生成一个 24 位包含符号的强密码
把 Automation/CI vault 加入 op_run 的允许列表

工具能力 15

vault_list 只读

列出服务账号可访问的保险库（ID、名称、描述、类型）。

item_lookup 只读

按标题子串搜索保险库中的条目，可选 limit（最大 200）。

item_list 只读

列出保险库中全部条目（ID、标题、类别、标签、更新时间）——不含密钥。

item_get 只读

获取条目完整信息：标题、类别、标签、笔记、字段。除非 reveal: true，隐藏值保持不可见。支持 op:// 引用或 vaultId + itemId。

password_read 只读

通过 op:// 引用或 ID 读取单个字段（默认 password）。除非 reveal: true，仅返回元数据；建议优先用 op_run 使用密钥。

op_check_ref 只读

校验 op://vault/item/field 引用，仅返回非机密元数据（保险库、条目、字段），绝不返回值本身。

password_create 写入

创建登录或密码条目（用户名、URL、标签、笔记），returnSecret 默认为 false。

note_create 写入

创建安全笔记，可附带标签与自定义字段。

展开其余 7 个工具

password_update 写入

轮换密码或隐藏字段（字段缺失时会自动创建）。

item_edit 写入

更新标题、笔记（空字符串清除）、标签、URL；可新增/更新或移除字段，未被引用的字段不受影响。

password_generate 只读

生成加密安全的随机密码（长度 8–128，可切换符号/数字/大写字母）。

password_generate_memorable 只读

基于约 500 词列表生成易记的口令短语（可配置词数、分隔符、数字/符号后缀）。

op_run 写入

在本地运行命令（command 或 argv），将匹配 op://… 的环境变量值注入子进程；返回输出中已解析的机密会被脱敏。

item_archive 写入

将条目移入归档（从常规视图中隐藏）。

item_delete 破坏性

永久删除条目——不可撤销。

使用场景

让 AI 助手列出并管理自动化保险库中的凭据

在本地命令中以 op:// 引用注入密钥而不泄露明文

批量轮换 CI / 机器人账号密码

审计保险库中的重复或异常条目

生成强随机密码或易记口令短语

支持客户端

Claude Desktop

Cursor

VS Code

Codex

Gemini部分支持

依据项目文档列出，未经本站实测。

详细介绍

由社区构建的 1Password MCP 服务器（非官方产品，Apache-2.0 许可），通过 1Password 服务账号让 Claude、Cursor、VS Code Copilot、OpenAI Codex 等 MCP 客户端管理保险库与凭据。内置 15 个工具、4 个工作流提示和 3 个可浏览资源，核心安全设计是优先使用 op:// 引用和 op_run 注入，使明文密钥无需出现在模型对话中。基于 MCP TypeScript SDK v2，支持 2026-07-28 协议协商并兼容旧版客户端，运行需 Node.js 20+。