TiMemMCP Server 实战：给Cursor / Claude Code 接入五层时序记忆

TiMem MCP Server 实战给 Cursor / Claude Code 接入五层时序记忆背景AI IDE 的记忆困境用过 Cursor 或 Claude Code 的开发者都会有同感每次开新对话AI 对你的项目背景一无所知。昨天讨论好的架构决策、反复强调的代码风格偏好、已经踩过的坑——全部清零。根本原因是现有 AI IDE 没有跨会话持久化记忆的机制。Context window 只在单次会话内有效新会话就是新白板。TiMem 上线了 MCP Server通过标准化的 MCP 协议接入 AI IDE为对话过程提供持久化记忆层彻底解决这个问题。什么是 TiMem MCPMCPModel Context Protocol是 Anthropic 提出的开放协议允许 AI 助手在对话过程中调用外部工具。TiMem MCP Server 基于此协议提供两个核心工具create_memory将当前会话内容存入 TiMem 记忆系统search_memories根据问题检索历史记忆支持按层级L1-L5过滤TiMem 底层使用**时序记忆树TMT**架构五层自动归纳L1 原始对话片段 ← 毫秒级写入保留原始细节 ↓ L2 会话摘要 ← 对话结束后自动提炼 ↓ L3 每日总结 ← 跨会话日维度归纳 ↓ L4 每周总结 ← 中期规律提取 ↓ L5 人物画像 ← 全生命周期稳定描述 查询时系统根据问题复杂度自动选层无需手动指定。这是 TiMem 与 Mem0 等扁平记忆框架最核心的区别。 --- ## 接入步骤 ### 前置条件 - 安装 uvPython 包管理工具 bash curl -LsSf https://astral.sh/uv/install.sh | sh在 TiMem 控制台 获取 API Key第一步配置 MCP Server将以下配置添加到对应 AI IDE 的 MCP 设置文件中Claude Code~/.claude/settings.json{mcpServers:{TiMEM-MCP:{command:uvx,args:[timem-mcp],env:{TiMEM_API_KEY:your-api-key-here,TiMEM_API_HOST:https://api.timem.cloud}}}}**Cursor**~/.cursor/mcp.json配置格式相同。 ### 第二步配置 AI 使用规则 在CLAUDE.md或.cursorrules 中加入你可以使用 TiMEM MCP 服务器的记忆管理工具使用 create_memory 将重要对话内容、技术决策、用户偏好存储为记忆使用 search_memories 在开始新任务时检索相关历史记忆第三步重启并验证重启 AI IDE 后在新对话中提及记忆相关内容观察 AI 是否自动调用 TiMEM MCP 工具。核心工具参数详解create_memory参数必填默认值说明messages✅-role content 格式的消息列表session_id✅-会话标识符agent_id❌“default-expert-001”智能体 IDdomain❌“general”业务领域可用于隔离不同项目记忆domain 字段的实用价值不同项目设置不同 domain记忆完全隔离避免项目间上下文混串。search_memories参数必填默认值说明query❌-搜索关键词layer❌自动记忆层级 L1-L5domain❌-业务领域过滤limit❌10返回结果数量按 layer 检索的典型用法查原始对话细节 → layer: L1 查近期状态 → layer: L3 查整体画像 → layer: L5性能数据TiMem 在主流长对话记忆基准上的表现基准测试Mem0MemOSTiMemLoCoMo~64%69.24%75.30%LongMemEval-S~65%68.68%76.88%Token 消耗基准中等减少 52.20%五层时序树结构让 TiMem 在长对话场景下比扁平检索框架高出 10 个百分点同时通过层级归纳大幅减少检索时的 token 消耗。典型使用场景场景一项目长期开发第一天告诉 AI「我们用 Go数据库是 PostgreSQL不用 ORM错误处理统一用 errors.As」。之后每次开新会话AI 通过 search_memories 检索项目规范直接按规范写代码不需要重复说明。场景二调试历史复用某个复杂 bug 的定位过程存入记忆。下次遇到类似现象AI 能直接检索到历史分析路径避免重复踩坑。场景三多项目隔离用 domain 字段区分不同项目A 项目的技术规范不会影响 B 项目的对话。总结TiMem MCP Server 的接入成本极低——修改一个 JSON 文件加几行规则不改任何业务代码。但它把 AI IDE 从「无状态工具」变成了「有记忆的开发搭档」在长期项目开发场景下体验提升非常明显。GitHubhttps://github.com/TiMEM-AI/timem在线体验https://playground.timem.cloud技术文档https://docs.timem.cloud