---

name: agent-memory-mcp description: "一个混合记忆系统，为 AI 代理提供持久化、可搜索的知识管理（架构、模式、决策）。" risk: unknown source: community date_added: "2026-02-27"

代理记忆技能

此技能提供持久化、可搜索的记忆库，自动与项目文档同步。它作为 MCP 服务器运行，允许读取/写入/搜索长期记忆。

前置条件

• Node.js（v18+）

设置

1. 克隆仓库： 将 agentMemory 项目克隆到代理的工作区或并行目录：

   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
   

2. 安装依赖：

   cd .agent/skills/agent-memory
   npm install
   npm run compile
   

3. 启动 MCP 服务器： 使用辅助脚本为当前项目激活记忆库：

   npm run start-server <project_id> <absolute_path_to_target_workspace>
   

   当前目录示例：

   npm run start-server my-project $(pwd)
   

功能（MCP 工具）

memory_search

按查询、类型或标签搜索记忆。

• 参数：query（字符串），type?（字符串），tags?（字符串数组）
• 用法："查找所有认证模式" -> memory_search({ query: "authentication", type: "pattern" })

memory_write

记录新知识或决策。

• 参数：key（字符串），type（字符串），content（字符串），tags?（字符串数组）
• 用法："保存此架构决策" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })

memory_read

按键检索特定记忆内容。

• 参数：key（字符串）
• 用法："获取认证设计" -> memory_read({ key: "auth-v1" })

memory_stats

查看记忆使用分析。

• 用法："显示记忆统计" -> memory_stats({})

仪表板

此技能包含一个独立仪表板来可视化记忆使用情况。

npm run start-dashboard <absolute_path_to_target_workspace>

访问地址：http://localhost:3333

何时使用

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来要求澄清。