1. 服务概述一句话简介为AI代理提供持久化、可搜索、版本化的记忆存储基于ValkeyRedis兼容后端通过HTTP暴露MCP服务器服务名称memory-mcp版本号最新版本开发者/提供方joshdougall协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点持久化存储存储带有标签、类型和项目范围的命名记忆条目高级搜索标签交集搜索、类型/项目过滤、子字符串搜索命中跟踪条目访问次数越多排名越靠前版本控制完整的版本历史支持回滚8个MCP工具涵盖搜索、获取、设置、列表、删除、历史、回滚、清理等功能Prometheus指标在/metrics端点暴露Prometheus指标用于监控服务器性能和使用情况可选认证支持Bearer令牌认证多后端支持支持Redis、Valkey、KeyDB、Upstash等Redis兼容服务器3. 使用场景描述该服务适合在什么情况下使用决策记录存储项目决策、设计选择、技术方案等模式记录记录代码模式、最佳实践、解决方案模式反馈存储保存用户反馈、代码审查意见、改进建议事件追踪记录事故、问题、解决方案项目知识库构建项目范围的知识库和参考信息状态管理跟踪项目状态、配置信息、环境设置跨会话记忆在多个会话之间保持AI代理的记忆和上下文4. 接入方式4.1 服务端点memory-mcp通过HTTP端点提供服务MCP端点http://127.0.0.1:3106/mcp健康检查GET /healthPrometheus指标GET /metrics传输方式HTTP4.2 认证与权限服务支持可选的Bearer令牌认证默认无认证绑定到127.0.0.1时安全启用认证设置环境变量MEMORY_MCP_AUTH_TOKEN生成令牌openssl rand -hex 32认证请求所有POST /mcp请求必须包含Authorization: Bearer token公开端点GET /health和GET /metrics始终无需认证4.3 数据格式每个记忆条目存储为Redis哈希包含以下字段字段描述title简短描述性标题body完整内容type条目类型pattern、decision、reference、feedback、incident、project、entity、statetags逗号分隔的标签列表source谁编写的project项目范围空跨项目created创建的ISO日期updated最后更新的ISO日期hits通过memory_get检索的次数ttl过期时间秒可选4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { memory: { type: http, url: http://127.0.0.1:3106/mcp, headers: { Authorization: Bearer your-token } } } }5. 接口定义5.1 可用工具工具名称描述功能memory_search通过标签交集、类型、项目或文本子字符串搜索搜索记忆条目memory_get通过ID获取一个条目增加命中计数器获取单个记忆memory_set创建或更新条目每次写入都版本化存储记忆memory_list列出条目可选类型/项目过滤列出记忆memory_delete删除条目先写入墓碑版本删除记忆memory_history查看条目的版本历史查看历史memory_rollback将条目恢复到以前的版本回滚版本memory_prune_candidates显示零命中的陈旧条目供审查只读清理建议5.2 记忆类型支持以下记忆类型pattern模式记录decision决策记录reference参考信息feedback反馈信息incident事件记录project项目信息entity实体信息state状态信息5.3 使用示例# 存储决策 memory_set( title使用Valkey作为缓存, body决定使用Valkey而不是Redis因为..., typedecision, tagscaching,valkey,redis, projectmy-project ) # 搜索记忆 memory_search( tagscaching,valkey, typedecision ) # 获取记忆 memory_get(idmem:abc123) # 查看历史 memory_history(idmem:abc123) # 回滚到之前版本 memory_rollback(idmem:abc123, version2)6. 快速开始6.1 环境要求Docker推荐使用Docker部署Redis/Valkey需要Redis兼容的后端存储可选Node.js环境用于本地开发6.2 安装步骤使用Docker Compose推荐# 复制环境配置 cp .env.example .env # 可选在.env中设置MEMORY_MCP_AUTH_TOKEN # 启动服务 docker compose up -d使用现有Redis或Valkey# 在.env中设置 VALKEY_URLredis://your-host:6379 # 只启动memory-mcp服务 docker compose up -d memory-mcp本地构建docker compose build docker compose up -d6.3 代理设置将AGENTS.md从仓库复制到项目根目录然后注册MCP服务器Claude Code# 无认证 claude mcp add memory --transport http http://127.0.0.1:3106/mcp # 有认证 claude mcp add memory --transport http http://127.0.0.1:3106/mcp \ --header Authorization: Bearer your-tokenCursor# 添加到~/.cursor/mcp.json全局或.cursor/mcp.json项目 { mcpServers: { memory: { url: http://127.0.0.1:3106/mcp, headers: { Authorization: Bearer your-token } } } }7. 注意事项重要提示许可协议MIT许可证默认无认证绑定到127.0.0.1时安全仅在本地访问启用认证绑定到0.0.0.0时必须设置AUTH_TOKEN版本历史限制默认每个条目最多20个版本快照条目数量警告默认软上限300个条目超过时警告内存限制容器内存上限默认256m数据持久化数据存储在Redis/Valkey中确保后端持久化配置正确配置变量变量默认值描述MEMORY_MCP_BIND127.0.0.1绑定接口使用0.0.0.0时必须设置AUTH_TOKENMEMORY_MCP_HOST_PORT3106主机暴露的端口MEMORY_MCP_AUTH_TOKEN*(空)*/mcp的Bearer令牌空无认证MEMORY_MCP_MAX_ENTRIES_WARN300软上限超过时警告MEMORY_MCP_MAX_VERSIONS_PER_ENTRY20每个条目的最大版本快照数MEMORY_MCP_MEM_LIMIT256m容器内存上限