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