智能体记忆 MCP (Model Context Protocol)

Agent Memory 技能

该技能提供一个持久且可搜索的记忆库，可与项目文档自动同步。它以 MCP 服务器形式运行，支持对长期记忆的读取、写入和搜索。

前置条件

• Node.js (v18+)

安装步骤

1. 审查仓库：
请求用户批准对指定仓库的网络访问权限，然后将固定的修订版本克隆到临时目录（而非活动的技能路径）：

review_dir="$(mktemp -d)"
   git clone --filter=blob:none https://github.com/webzler/agentMemory.git "$review_dir/agent-memory"
   git -C "$review_dir/agent-memory" checkout --detach 0409b7b7bb6fe443d0d4b6a6b1ee0d4df214f3cd
   git -C "$review_dir/agent-memory" ls-files

阅读所有随附文件并检查 package.json、锁文件、生命周期脚本、网络行为、凭据访问及文件系统范围。展示审查结果和具体提交哈希，然后等待用户明确批准。

2. 安装已审查的修订版本：

批准后，将审查过的目录树复制到用户选择的位置。仅在审查完包脚本后安装锁定依赖：

cd <approved-agent-memory-directory>
   npm ci
   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 (string), type? (string), tags? (string[])

• 用法: "查找所有身份验证模式" -> memory_search({ query: "authentication", type: "pattern" })

memory_write

记录新知识或决策。

• 参数: key (string), type (string), content (string), tags? (string[])

• 用法: "保存此架构决策" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })

memory_read

通过键值检索特定的记忆内容。

• 参数: key (string)

• 用法: "获取身份验证设计" -> memory_read({ key: "auth-v1" })

memory_stats

查看记忆使用情况的分析数据。

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

控制面板

该技能包含一个独立的控制面板，用于可视化记忆使用情况。

npm run start-dashboard <absolute_path_to_target_workspace>

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

使用场景

局限性

• 仅在任务明确符合上述范围时使用此技能。

• 不要将输出结果视为环境特定验证、测试或专家审查的替代方案。

• 如果缺少必要的输入、权限、安全边界或成功标准，请停止操作并请求澄清。

• 在更改固定修订版本前请重新审查上游代码；固定提交可提高可复现性，但不能保证绝对信任。