# 透過 MCP 公開的工具

連線的 agent 看得到哪些 Agenvoy 工具，以及新工具如何免重啟出現。

## 公開的工具

| 工具 | 用途 |
|---|---|
| `script_*` / `api_*` / `ext_*` | 使用者建立的工具與擴充工具（自磁碟自動探索） |
| `edit_tool` | 建立或覆寫工具檔（`mode=write`）、在檔內做字串取代修正（`mode=patch`）、丟棄過時工具（`mode=remove`）；`tag` 選擇 tool.json、script.py 或 API 描述檔 |
| `test_tool` | 以範例輸入在 sandbox 中執行 script 工具 |
| `list_tools` | 列出 server 公開的所有工具 |
| `store_secret` | 以遮蔽輸入取得憑證並直接寫入 keychain |
| `tool_generate_guide` | 回傳工具建置契約（命名、範本、執行流程、檢查清單）。`script_tool_generate_guide` 保留為別名 |
| `api_public_api_list` | 依類別瀏覽免費公開 API 以供建立工具 |

橋接工具（`edit_tool`、`test_tool`、`store_secret`）與 Agenvoy 內部 runtime 共用——相同 handler、相同 schema，透過 `toolRegister` 分派。無重複實作。

## Hot reload

Server 透過 `fsnotify` 監看工具目錄。當工具被建立、修改或刪除時，server 會自動重新掃描並送出 `notifications/tools/list_changed` — client 無需重連即可刷新工具清單。

***

> [!NOTE]
> 本文件由 Claude 讀取完整原始碼後自動生成。