mcpField
A
agent-memory-mcp

agent-memory-mcp

github.com/davila7Agent 工作流33.0k575 次安装今天更新
代码仓库

关于 agent-memory-mcp

为 Agent 提供可持久保存和搜索的记忆库，并与项目文档同步。它通过 MCP 服务读写长期记忆，也附带独立仪表板。

主要功能

  1. 01按查询、类型或标签搜索
  2. 02写入记忆与决策
  3. 03按键读取指定记忆
  4. 04查看记忆使用统计
  5. 05仪表板可视化记忆用量

适用场景

  1. 01保存项目架构决策
  2. 02查找过往模式或项目记忆

MCP 相关

作为 MCP 服务提供记忆搜索、写入、读取和统计工具，供 MCP 客户端访问长期记忆。

安装

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

$npx skills add https://github.com/davila7/claude-code-templates --skill agent-memory-mcp

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

详细介绍

Agent 记忆技能

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

前置条件

  • Node.js (v18+)

设置

  1. 克隆仓库： 将 agentMemory 项目克隆到你的 Agent 工作区或一个同级目录中：

    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 (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

评论

支持 Markdown