mcpField
A
agentmemory-mcp-tools

agentmemory-mcp-tools

github.com/rohitg00Agent 工作流30.0k11.0k 次安装今天更新
代码仓库

关于 agentmemory-mcp-tools

agentmemory-mcp-tools 是介绍 agentmemory 所提供 MCP 工具的技能,帮助 Agent 按文档中的结构选择记忆捕获、检索、会话、图谱、槽位及治理操作。

主要功能

  1. 01索引 MCP 工具类别与结构
  2. 02保存和搜索记忆
  3. 03检索会话、文件和时间线
  4. 04查询知识图谱与结构化槽位
  5. 05执行治理和健康检查

适用场景

  1. 01保存见解以供后续检索
  2. 02通过具体查询搜索记忆
  3. 03查看会话或记忆关系

MCP 相关

该技能介绍 agentmemory MCP 服务提供的工具,包括记忆捕获、检索、会话、知识图谱、结构化槽位、治理和健康检查操作。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-mcp-tools

安装后在 Claude Code 中输入/agentmemory-mcp-tools确认已加载。

附带文件REFERENCE.mdTROUBLESHOOTING.md

详细介绍

This skill 用于索引 agentmemory 的 MCP 工具。请使用已连接服务的工具清单和架构;原生记忆提供方可能以不同名称提供较少的工具集。需要完整功能的 Hermes 和 OpenClaw 技能,需要单独连接到正在运行的守护进程的 MCP。对于 Pi 和 OMP,请使用 --with-mcp 连接,以启用更广泛的工作流。Pi 使用 mcp__agentmemory__ 前缀公开 MCP 名称;OMP 则通过其 write 工具,将 MCP 操作作为 xd://mcp__agentmemory_<tool> 设备公开。

快速入门

保存后再回忆:

  1. 使用 memory_save,并提供 content(见解)、concepts(逗号分隔的关键词)和 files(逗号分隔的路径)。
  2. 使用 memory_smart_search,并提供 query、limit 和 targetLayer: "memory",以便之后检索已保存的知识。省略 targetLayer 可同时搜索已捕获的观察记录。此操作会执行 BM25、向量和图扩展混合搜索。

工具系列

  • 捕获:memory_save、memory_compress_file。自动观察记录使用原生钩子或 POST /agentmemory/observe,而不是 MCP 观察工具。
  • 检索:memory_smart_search、memory_recall、memory_file_history、memory_timeline、memory_vision_search。
  • 会话和提交:memory_sessions、memory_commits、memory_commit_lookup。
  • 知识和图谱:memory_lesson_save、memory_lesson_recall、memory_graph_query、memory_relations、memory_patterns、memory_crystallize。
  • 结构化槽位:memory_slot_create、memory_slot_append、memory_slot_get、memory_slot_list、memory_slot_replace、memory_slot_delete。
  • 治理和健康检查:memory_governance_delete、memory_audit、memory_verify、memory_heal、memory_diagnose。

工作流

  1. 根据任务选择范围最窄的工具。开放式回忆优先使用 memory_smart_search;已有明确查询时使用 memory_recall;列出会话时使用 memory_sessions。
  2. 调用前,请在 REFERENCE.md 中查找准确的参数名称及必填项。
  3. 仅传入已记录的字段。REST 处理程序会将字段列入白名单,并丢弃未知字段。
  4. 对于受预算限制的 memory_recall,请区分 matched_count: 0 和 excluded_by_budget > 0。对于被截断或省略的 ID,请使用 memory_smart_search 和 expandIds 展开,并保留相同的范围筛选条件。

另请参阅

  • agentmemory-rest-api:HTTP 等效接口。
  • agentmemory-config:工具可见性和功能标志。
  • 用户可调用的操作技能(remember、recall、recap、handoff、forget)封装了最常用的工具。

参考

包含参数和核心工具集标记的完整工具表位于 REFERENCE.md,由源代码生成,因此内容始终保持同步。

评论

支持 Markdown