主题
附录 K:MCP 工具全表(主 30 + 扩展 40 = 70)
2026-11-17 审查 #18:这两个工具面此前没有任何清单(只在正文里零散提到), 而它们是 AI 能做什么的全部边界。清单直接从运行中的
tools/list生成, 并用docs/tools/check-mcp-tools.mjs做漂移检查(需要两个 MCP 令牌,故不进 CI 文档检查,手动/巡检时跑)。
- 主 MCP:
POST /api/agent/mcp,令牌/etc/vite-cosmos/agent-mcp-token,作用域mcp;- 扩展 MCP:
POST /api/agent/extensions/mcp,令牌/etc/vite-cosmos/agent-ext-token。
| # | 工具名 | 归属 | 作用(截断) |
|---|---|---|---|
| 1 | album_photo | 主 MCP | 相册:把他的照片收进相册,以及查「我有哪些相册」。 什么时候用: |
| 2 | article_draft_create | 主 MCP | 创建一篇文章草稿(只进草稿,绝不发布)。可给大纲与参考记忆 ID |
| 3 | talk_publish | 主 MCP | 发布一条「说说」(短动态,发出后直接出现在博客时间线上)。**只在博主明 |
| 4 | daily_brief | 主 MCP | 一次取全今日上下文:今日课程 + 待办(未完成/已完成/逾期)+ 今日提 |
| 5 | daily_todo | 主 MCP | 待办操作:list 查今天的待办;add 新建待办;done 标记完成; |
| 6 | schedule_fix | 主 MCP | 口语纠正:他说「不是周三,是周四」「那条记错了」时,用这个改掉或删掉 — |
| 7 | daily_course | 主 MCP | 课程表:记下 / 查看 / 删除「哪一天有什么课」。**按天记, |
| 8 | remind | 主 MCP | 到点提醒:任何「到时候提醒我」的事都记这里(会议、面试、交材料、 |
| 9 | event_record | 主 MCP | 记一条生活事件(跑了几公里、睡了几个小时、花了多少钱、去了哪)。 |
| 10 | event_query | 主 MCP | 聚合查询生活数据(不是相似度检索)。问「今年跑了多少公里」「这周 |
| 11 | plan_deviation | 主 MCP | 计划 vs 实际的偏差:课程表上安排了、但没有记录到的事 |
| 12 | image_ingest | 主 MCP | 看图之前先做一次轻量检查(V87;每日上限可在后台配置,默认 0 |
| 13 | memory_search | 主 MCP | 搜索长期记忆(关于博主的事实/偏好/事件/情绪/关系/目标)。需要历史细 |
| 14 | memory_write | 主 MCP | 写入一条长期记忆(幂等:同内容重复写不会产生重复条目)。只在用户明确要求 |
| 15 | memory_fact_upsert | 主 MCP | 写入/更新一条事实型记忆(subject + predicate + o |
| 16 | memory_forget | 主 MCP | 遗忘记忆。soft(默认)= 失效但保留记录、可回溯;hard = 物理 |
| 17 | memory_verify | 主 MCP | 记录一条记忆是对是错(证伪)。当他说「对,就是这样」用 conf |
| 18 | narrative | 主 MCP | 叙事章节:把一段时间的记忆压成一段能讲的经过。问「这几个月你是怎 |
| 19 | ritual | 主 MCP | 仪式与约定(关系层)。固定的问候、睡前的最后一句、周日一起看看这 |
| 20 | procedure | 主 MCP | 我们通常怎么合作(程序记忆)。记的是「遇到什么情况按什么顺序做」 |
| 21 | disagreement | 主 MCP | 你们之间的分歧(反谄媚)。只在你真的不认同他的判断、并且 |
| 22 | open_loop | 主 MCP | 未了线头:记下 / 收口 / 查看「我们之间还悬着的事」—— 约定、承诺 |
| 23 | emotion_note | 主 MCP | 记下他此刻的感受(不是发生了什么,那属于 memory_writ |
| 24 | care_reply | 主 MCP | 把博主对主动关怀的回答记回去 —— 关怀问过「上次你说…后来怎么 |
| 25 | profile_update | 主 MCP | 把关于他本人的长期设定记下来(他怎么被称呼、作息、想让它用什么语 |
| 26 | job_run | 主 MCP | 投递一个后台任务:立即返回 job id,不阻塞。可用任务:ar |
| 27 | job_status | 主 MCP | 查最近的后台任务执行记录(job id / 任务名 / 触发来源 / 状 |
| 28 | reflect | 主 MCP | 让 Hindsight 基于长期记忆与认知进行多轮推理,返回 answe |
| 29 | kb_search | 主 MCP | 检索博主写过的内容(文章、笔记、说说,以及他上传的资料)。当博主 |
| 30 | session_search | 主 MCP | 翻历史会话的原话:按关键词搜过去对话里真实说过的话(他的发言与你 |
| 31 | extension_search | 扩展 MCP | 搜索已安装/可用的扩展 |
| 32 | extension_get | 扩展 MCP | 查看扩展详情 |
| 33 | extension_capability_list | 扩展 MCP | 列出可用 capability |
| 34 | extension_capability_get | 扩展 MCP | 查看 capability 契约 |
| 35 | extension_draft_create | 扩展 MCP | 创建扩展草稿 |
| 36 | extension_draft_update | 扩展 MCP | 更新扩展草稿 |
| 37 | extension_draft_list | 扩展 MCP | 列出草稿(离开编辑器后靠它找回) |
| 38 | extension_draft_get | 扩展 MCP | 查看草稿 |
| 39 | extension_validate | 扩展 MCP | 校验草稿 |
| 40 | extension_test | 扩展 MCP | dry-run 草稿(录制模式:不真实外呼、不提交 effect,返回将 |
| 41 | extension_publish | 扩展 MCP | 发布草稿为不可变版本 |
| 42 | extension_install | 扩展 MCP | 安装扩展 |
| 43 | extension_activate | 扩展 MCP | 启用扩展(同时会把它名下被暂停的触发器重新启用) |
| 44 | extension_pause | 扩展 MCP | 暂停扩展(同时停掉它名下所有触发器,避免调度器继续产生空跑记录) |
| 45 | extension_run | 扩展 MCP | 手动运行扩展 |
| 46 | extension_runs | 扩展 MCP | 查看运行历史 |
| 47 | extension_effects | 扩展 MCP | 查看运行 effect |
| 48 | extension_trigger_create | 扩展 MCP | 创建触发器。type 支持 schedule(必须给 config.cr |
| 49 | extension_trigger_update | 扩展 MCP | 修改触发器(可改 config.cron/时区/target、concu |
| 50 | extension_trigger_list | 扩展 MCP | 列出触发器 |
| 51 | extension_trigger_delete | 扩展 MCP | 删除触发器 |
| 52 | extension_approval_list | 扩展 MCP | 列出审批 |
| 53 | extension_approval_get | 扩展 MCP | 查看单条审批详情 |
| 54 | extension_rollback | 扩展 MCP | 回滚到指定版本(需该版本仍有有效 grant) |
| 55 | extension_uninstall | 扩展 MCP | 卸载扩展(先停 trigger,再 disable installati |
| 56 | extension_logs | 扩展 MCP | 查看某次运行的事件日志 |
| 57 | extension_effect_retry | 扩展 MCP | 重试失败的副作用(置回 pending) |
| 58 | extension_secret_set | 扩展 MCP | 设置扩展密钥(值只进加密存储,绝不回显) |
| 59 | extension_secret_list | 扩展 MCP | 列出扩展已配的密钥名(不含值) |
| 60 | extension_secret_delete | 扩展 MCP | 删除扩展密钥(配错名字时清掉) |
| 61 | extension_trigger_pause | 扩展 MCP | 暂停触发器 |
| 62 | extension_trigger_resume | 扩展 MCP | 恢复触发器 |
| 63 | extension_run_get | 扩展 MCP | 查看单次运行详情 |
| 64 | extension_kill_switch | 扩展 MCP | 查看扩展总开关状态 |
| 65 | extension_platform_status | 扩展 MCP | 查看扩展平台总开关(调度器/副作用/熔断等)。排查"启用却不动"时先看这 |
| 66 | extension_selfcheck | 扩展 MCP | 插件自检(校验 + 记录式 dry-run),通过后才允许启用 |
| 67 | extension_failure_list | 扩展 MCP | 最近失败的插件运行(自修入口) |
| 68 | extension_repair_report | 扩展 MCP | 上报一次修复结果(写自修台账,幂等) |
| 69 | extension_draft_patch | 扩展 MCP | 基于已发布版本克隆一个修复草稿 |
| 70 | extension_trigger_auto | 扩展 MCP | 按 manifest 装配触发器(幂等,装完补一次保险) |