用途:knowledge-graph 用于在多次 agent 会话之间构建并查询持久化的知识图,记录实体、关系和观察,帮助代理随时间累积关于项目、人员、代码库和领域的结构化知识,实现可跨上下文重置的长期记忆。
主要能力:支持创建实体、创建有向关系、向已有实体追加观察、删除实体/观察/关系、读取完整图、按查询字符串搜索节点以及按名称获取特定实体。内置实体与关系模式,实体包含稳定的 UUID、名称、类型、观察列表和时间戳,常见类型包括 person、service、codebase、file、concept、organization、tool、decision、issue、feature。
使用方式:推荐为 Claude Agents 使用官方 MCP memory server,安装命令为 npx -y @modelcontextprotocol/server-memory,可在 settings.json 中配置 memory server,并通过 MEMORY_FILE_PATH 指定持久化文件。支持的 MCP 工具包括 create_entities、create_relations、add_observations、delete_entities、delete_observations、delete_relations、read_graph、search_nodes、open_nodes。没有 MCP memory server 时,可使用本地 JSON 知识图,文件默认位于 .claude/context/memory/knowledge-graph.json,项目专属图可命名为 kg-<project-name>.json。
适用场景:需要跨会话记住结构化事实、从观察中构建代码库或项目领域模型、追踪人员/系统/概念之间的关系,以及实现能存活于上下文重置的长期记忆。
限制与注意事项:MCP server 图默认存储在内存中,不持久化,需设置 MEMORY_FILE_PATH 才会保存。不要用可变名称作为实体 ID,不要在观察中缺失时间戳,不要使用 related_to 这类对称关系类型,应始终使用有向关系。不要任由图无限增长,应淘汰超过 90 天且无近期观察的实体,避免每次查询完整图,应使用 search_nodes 进行具体查询。资料中未提供收费、价格或平台支持范围等信息。