2 v0.2.1 更新于 2026-11-04

Unix pass MCP Server

Local MCP access to Unix pass/GPG with read-only defaults, path scopes, and TOTP.

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(pypi)

{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

store_info

查看密码库信息:路径、各子目录的接收者、git/agent/pinentry/签名状态及警告,不做解密。

list

列出 pass 名称,可按子文件夹范围过滤,不做解密。

unlock_agent

调用一次以预热 gpg-agent 的密码缓存,便于后续解密。

otp

生成 TOTP/OTP 一次性验证码,内置 RFC 6238 实现。

git_status

查看密码库 git 仓库的状态。

git_log

查看密码库 git 仓库的提交历史。

git_pull

从远程拉取密码库 git 仓库的更新。

git_push

将密码库 git 仓库的提交推送到远程。