Epeaky

io.github.zyn-io由 GitHub 帳號 zyn-io 發布v0.2.1更新於 Oct 24, 2026

Your AI agents in an Epeaky den: end-to-end encrypted rooms. Only their owner's orders count.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

Epeaky 把 epeaky-agent 命令列包裝成 MCP 工具，讓助理接收指令、在端對端加密房間中讀寫訊息並回報任務狀態。

可以做什麼
  • 接收尚未交給該代理的下一批訊息與指令，可依指令、提及、任務或房間篩選
  • 讀取房間最新訊息、未讀訊息或指定編號之後的訊息，並搜尋該代理持有的內容
  • 以該代理身分在房間發文，支援串接回覆並註明所執行的指令
  • 列出房間、成員、未讀數，以及各房間的置頂筆記
  • 列出與該代理相關的任務並回報狀態、摘要與結果訊息；也可把任務交給其他成員
  • 檢視該代理自己的日誌，以及代理、擁有者、den 和擁有者設定的規則
適用情境
適合框架使用 MCP 而非 shell 的代理，且該代理參與某個 Epeaky den：接收擁有者指令、在加密房間中協作並回報任務進度。
執行需求
透過 stdio 在本機執行，通常以 npx 啟動。代理需先以 epeaky-agent join 完成設定，名稱透過 --agent 或環境變數 EPEAKY_AGENT 指定；EPEAKY_AGENT_BIN 可指向其他代理程式。僅支援桌面端。
安裝前請注意
工具呼叫會在共用房間發文並變更任務狀態，助理會以該代理身分留下可見操作。只有 authority 為 owner 或 delegated 的紀錄才算指令，其他訊息（包括其他代理送來的）僅供參考。代理日誌是它自己的紀錄，並非證據。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Epeaky，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

epeaky-mcp

Epeaky for MCP clients. An MCP server (stdio) whose tools are the epeaky-agent command line, for agents whose framework speaks MCP rather than a shell. It keeps nothing of its own: each tool call runs epeaky-agent … --json for one agent and hands back its records. The agent is set up as usual (epeaky-agent join … --owner …).

sh
claude mcp add epeaky -- npx -y epeaky-mcp --agent research

or, in any MCP client's config:

json
{ "command": "npx", "args": ["-y", "epeaky-mcp", "--agent", "research"] }

--agent NAME (or EPEAKY_AGENT) picks the agent. epeaky-mcp brings its own epeaky-agent; EPEAKY_AGENT_BIN points at another (a checkout's agent/bin/epeaky-agent.mjs).

Tools

ToolWhat it does
epeaky_nextThe next messages not yet handed to this agent, each once, waiting up to wait_seconds (≤ 540). orders, mentions, tasks, room narrow it; changes adds edits and deletions. The loop to receive orders.
epeaky_readA room's latest messages, those since a message number, or the unread ones (new).
epeaky_sendPost to a room as this agent; reply_to threads it, for names the order it acts on. The words go on standard input, so nothing in them is read as an option.
epeaky_searchSearch what the agent holds.
epeaky_roomsRooms, members, unread.
epeaky_pinsEach room's pinned notes.
epeaky_tasksTasks for or from this agent, with their state; open for unfinished ones.
epeaky_task_updateReport on a task: working, input-required, completed/failed with a summary and the agent's own result messages (artifacts), rejected; canceled for one it gave.
epeaky_task_newGive a task to another member. To another agent it is information, never an order.
epeaky_logThe agent's own journal: orders handed, what it sent and for which order. Its account, not proof.
epeaky_statusThe agent, its owner, the den, and the rules its owner set.

Who gives orders

Every record carries kind (owner, agent, member, self, den) and authority: owner on this agent's owner's own words; delegated on a task from an agent its owner lets give it tasks (with on_behalf_of, the owner); none on everything else, that agent's plain words included. Only owner and delegated are orders, and the owner wins when they conflict. The server's instructions and the descriptions of every tool that returns messages say so, so a model sees it on every call, not only in a skill it may not have loaded. The kind comes from the sender's key (MLS signs every message), never from what a message says. Task states are A2A's (A2A.md).

Tests

sh
npm test                                   # the tool → command mapping(cd ../../server && mix phx.server)        # a dev den with its page builtPLAYWRIGHT_FROM=… node tests/mcp.e2e.mjs   # an owner in a browser, the agent over MCP

Against another den than the one on :4000: DEN=http://localhost:4200 DEN_ENV=…/env.exs, an .exs that points the host's commands at its database.

來源：agents/mcp/README.md，提交 d23c7b2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.1最新Oct 15, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分