[ PROMPT_NODE_22188 ]
agent-memory-mcp
[ SKILL_DOCUMENTATION ]
# 智能体记忆技能 (Agent Memory Skill)
该技能提供了一个持久化、可搜索的记忆库,可与项目文档自动同步。它作为 MCP 服务器运行,允许对长期记忆进行读取、写入和搜索。
## 前置要求
- Node.js (v18+)
## 安装设置
1. **克隆仓库**:
将 `agentMemory` 项目克隆到你的智能体工作区或平行目录中:
bash
git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
2. **安装依赖**:
bash
cd .agent/skills/agent-memory
npm install
npm run compile
3. **启动 MCP 服务器**:
使用辅助脚本为当前项目激活记忆库:
bash
npm run start-server
_当前目录示例:_
bash
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({})`
## 仪表盘
该技能包含一个独立的仪表盘,用于可视化记忆使用情况。
bash
npm run start-dashboard
访问地址:`http://localhost:3333`