Armadoc

link.armadocv0.1.0更新于 Oct 6, 2026

Send and read end-to-end encrypted documents. Your private key never leaves your machine.

概览

AI 生成的概览

让助手在你自己的机器上列出、解密到磁盘并发送 Armadoc 端到端加密文档。

功能
Armadoc 是一个本地 stdio MCP 服务器,同时提供命令行工具,用于端到端加密的文档共享。其工具可以列出别人发给你和你发出的文档、把文档文件解密到磁盘(默认按链接 ID 放在下载目录下),以及加密本地文件后发送,或邀请尚无密钥的收件人。读取只返回文件路径而非内容,因此只有助手打开文件时,文档内容才会进入其上下文。
适用场景
当你希望助手代为处理加密文档往来,同时私钥和明文始终留在你自己的电脑上时,可以使用它。它适合在桌面环境中交互式地读取或发送文档,不适合云端托管的助手。
运行要求
需要 Node 24 或更高版本,通过 npm 全局安装,并以本地命令 armadoc mcp 通过 stdio 运行。配对需要在同一台机器上用浏览器执行 armadoc login,为该机器登记密钥。服务器必须与 MCP 主机运行在同一台自己的电脑上;未声明任何环境变量或请求头。
安装前请注意
该服务器以你的身份操作 Armadoc 账户:可以发送文档,并把收到的文档解密到磁盘。私钥和凭据保存在本地配置目录中,armadoc logout 会将其删除,但该代理会一直留在你的账户中,直到你在设置里移除;已解密的文档也会留在下载目录。请求会向 Armadoc 报告你的 MCP 主机名称和版本。它无法在云端托管的助手中使用,因为那样密钥和明文会留在服务商的机器上。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Armadoc,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

armadoc

The armadoc CLI and a local stdio MCP server for Armadoc end-to-end encrypted document sharing. Your agent sends and reads documents as you; the private key and the plaintext never leave your machine.

Install

sh
npm install -g armadoc

Node 24 or later.

Pair

sh
armadoc login

This pairs this machine with your Armadoc account in a browser and enrolls a key for it. The key opens only what is sent to you after pairing; anything sent earlier still opens wherever you read it before.

armadoc status shows the pairing.

Add to an MCP host

The server is armadoc mcp, over stdio. Hosts with a JSON config take:

json
{  "mcpServers": {    "armadoc": { "command": "armadoc", "args": ["mcp"] }  }}

Requests from the server include the name and version your MCP host reports for itself, so Armadoc can see which hosts are in use.

The server has to run on your own computer, next to your MCP host. It won't work in cloud-hosted agents, because armadoc login needs a browser on the same machine. Even if it could pair there, your private key and the documents you read would sit on the provider's machines, possibly after the session ends.

Tools

ToolDoes
list_documentsLists documents sent to you and by you
read_documentDecrypts a document's files to disk, by default ~/Downloads/armadoc/<linkId>
send_documentEncrypts local files and sends them, or invites a recipient with no key yet

read_document returns file paths, not contents: what a document says enters the agent's context only if the agent opens the file.

Uninstall

sh
armadoc logoutnpm uninstall -g armadoc

armadoc logout deletes the private key and credentials in ~/.config/armadoc. The agent stays on your account until you remove it in settings, and documents it read stay in ~/Downloads/armadoc.

来源:packages/cli/README.md,提交 6ea183c

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.0最新Oct 6, 2026