Armadoc

Name: Armadoc
Author: armadoc.link

本地服务

armadoc.link文件与存储03 周前更新

代码仓库访问官网

关于 Armadoc

Armadoc 是用于端到端加密文档分享的命令行工具和本地 stdio MCP 服务。它让个人发送和读取文件，同时将私钥和明文保留在本机。

主要功能

01发送前在本机加密文件
02向收件人发送文档
03列出收件和发出的文档
04将文件解密到本地目录
05为脚本提供 JSON 输出

适用场景

01向收件人分享敏感文件
02读取通过 Armadoc 收到的文档
03让 Agent 列出、发送或读取文档

MCP 相关

本地 stdio MCP 服务提供列出、发送和读取文档的工具。读取操作会将文件解密到磁盘，并返回文件路径而非文档内容。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "link-armadoc-armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}

启动命令npx -y armadoc

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmarmadoc0.2.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
direction	enum	否	仅显示此方向；省略时显示两者inbound \| outbound

详细介绍

armadoc

用于 Armadoc 端到端加密文档共享的 armadoc CLI 和本地 stdio MCP 服务。可在终端中发送和读取文档，也可以让你的 Agent 代你操作；私钥和明文永远不会离开你的设备。

安装

npm install -g armadoc

需要 Node 24 或更高版本。也可以不进行全局安装，为每条命令添加 npx 前缀。

配对

armadoc login

此操作会在浏览器中将这台设备与 Armadoc 账户配对，并为账户注册一个密钥。该密钥只能打开配对后发送给你的内容；更早发送的内容仍可在你此前阅读它的地方打开。

armadoc status 会显示配对状态。

发送和读取

armadoc send report.pdf notes.txt --to [email protected] --to-name "Dustin Burrows"
armadoc ls
armadoc read https://armadoc.link/v/<linkId>

send 会在这台设备上加密文件，并以你登录时提供的名称发送给一位收件人。如果收件人还没有 Armadoc 密钥，则会通过电子邮件向其发送邀请，且不会上传任何内容；对方接受邀请后，再次运行同一条 send 命令即可完成发送。--expires 7d 可设置链接保持开放的天数，具体受你的套餐限制。

ls 或 list 会显示双向仍然开放的内容；使用 --inbound 或 --outbound 可缩小范围。read 接受邮件中的链接，也可只使用其 ID，并将文件保存到 ~/Downloads/armadoc/<linkId>，或指定的 --dir 目录。它绝不会覆盖文件。

list、read 和 send 支持使用 --json 输出可供脚本解析的内容。拒绝请求（例如超出套餐限制）会输出到 stderr，并返回退出代码 1。

在 Agent 中使用

Claude Code：

claude mcp add --scope user armadoc -- armadoc mcp

Codex：

codex mcp add armadoc -- armadoc mcp

其他宿主：服务为 armadoc mcp，通过 stdio 通信。重启或重新连接宿主即可加载该服务。

请求会标明由命令还是 MCP 服务发起；MCP 服务发出的请求还会包含 MCP 宿主报告的名称和版本，让 Armadoc 能了解客户端的使用情况。

该服务必须运行在你自己的电脑上，与 MCP 宿主处于同一设备。它无法在云托管的 Agent 中运行，因为 armadoc login 需要在同一台设备上使用浏览器。即使能够在那里配对，你的私钥和读取的文档也会存放在服务提供商的机器上，会话结束后也可能继续留在那里。

工具

工具	功能
`list_documents`	列出发送给你和由你发送的文档
`read_document`	将文档文件解密到磁盘，默认保存到 `~/Downloads/armadoc/<linkId>`
`send_document`	加密本地文件并发送，或向尚无密钥的收件人发送邀请

read_document 返回的是文件路径，而非文件内容：只有 Agent 打开文件后，文档内容才会进入其上下文。