跳到主要内容

MCP 接入指南

MCP 是羽忆当前阶段最值得优先支持的接入形态之一，因为它覆盖了大量以工具和资源为核心的 Agent 宿主。

适合通过 MCP 暴露的能力​

Resources​

  • 记忆列表
  • 最近记忆
  • 单条记忆详情
  • 最近一次任务召回结果

Tools​

  • write_memory
  • write_history_record
  • search_memory
  • recall_context_for_task
  • delete_memory
  • archive_memory
  • invalidate_memory
  • set_memory_mode

这样设计的好处是，宿主既可以把羽忆当成“可调用工具”，也可以把它当成“可读取资源”。

接入原则​

  • MCP Server 只做协议适配，不复制服务端业务逻辑
  • 所有认证最终仍落在服务端的 API Token 上
  • 返回结构应尽量贴近宿主可消费的文本或结构化块

最小接入流程​

  1. 在服务端管理台创建一个 MCP 专用 API Token
  2. 在 MCP Server 配置中填写 server_url 与 api_token
  3. 将标准 MCP tools / resources 映射到羽忆 REST API
  4. 在宿主里验证写入、召回和控制能力

为什么 MCP 值得优先做​

因为它天然适合作为“跨宿主记忆能力”的标准暴露层。相比为每个宿主单独开发一套专有插件，MCP 更容易形成统一接入模型，也更符合羽忆“宿主无关”的设计方向。