当前位置：首页 > news >正文

3步配置MCP知识图谱：让Claude拥有持久化记忆的简易教程

news 2026/5/25 7:08:30

3步配置MCP知识图谱：让Claude拥有持久化记忆的简易教程

【免费下载链接】mcp-knowledge-graphMCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development项目地址: https://gitcode.com/gh_mirrors/mc/mcp-knowledge-graph

你是否曾希望AI助手能记住之前的对话内容？想让Claude成为你的长期记忆伙伴吗？mcp-knowledge-graph正是你需要的解决方案！这是一个基于MCP协议的知识图谱服务器，为Claude等AI模型提供跨对话的持久化记忆存储。通过简单的配置，你就能让AI记住重要信息、人物关系和项目细节，打造真正智能的个人知识库。

🧠 为什么需要AI持久化记忆？

想象一下这样的场景：上周你告诉Claude一个重要的项目截止日期，今天再次询问时，它却完全不记得了。或者你分享过团队成员的联系方式，但下次讨论时AI需要你重新提供。这就是传统AI对话的局限性——缺乏持久化记忆。

mcp-knowledge-graph解决了这个痛点，让AI拥有"长期记忆"能力。它通过本地知识图谱存储实体、关系和观察，确保重要信息不会随着对话结束而消失。

Claude的MCP服务器列表显示mcp-knowledge-graph已成功集成，与其他功能服务器协同工作

🚀 快速入门：3步完成配置

第1步：全局内存配置（推荐）

在你的Claude Desktop配置文件中添加以下内容，创建全局记忆存储：

{ "mcpServers": { "Aim-Memory-Bank": { "command": "npx", "args": [ "-y", "mcp-knowledge-graph", "--memory-path", "/Users/yourusername/.aim" ] } } }

第2步：项目本地内存配置

如果你希望不同项目拥有独立的记忆空间，只需在项目根目录创建.aim文件夹：

mkdir .aim

系统会自动检测并使用项目本地存储，让你的知识图谱与项目完美结合！

第3步：验证配置成功

配置完成后，Claude将能够访问知识图谱工具。你可以通过"Available MCP Tools"查看所有可用工具。

Claude通过read_graph工具直接访问整个知识图谱，实现智能记忆检索

📊 理解AIM命名系统

AIM代表AI Memory，系统采用统一的命名规范确保清晰和安全：

.aim目录：AI内存文件专用目录，用于项目本地存储
aim_工具前缀：所有内存相关工具都以aim_开头，便于识别
_aim安全标记：每个内存文件的安全标识，防止误操作

主数据库：你的智能记忆中枢

主数据库是整个系统的核心，具有以下特点：

默认使用：所有操作默认使用主数据库
始终可用：在项目本地和全局位置都存在
跨对话持久化：所有对话中积累的知识都会保存
自动创建：无需手动设置，系统会自动维护

🛠️ 核心工具集详解

mcp-knowledge-graph提供了一系列强大的内存操作工具：

记忆存储与检索

aim_memory_store- 存储新记忆（人物、项目、概念）
aim_memory_search- 按关键词搜索记忆
aim_memory_read_all- 读取数据库中的所有记忆
aim_memory_get- 获取特定记忆

知识图谱构建

aim_memory_link- 连接两个记忆，构建知识网络
aim_memory_add_facts- 向现有记忆添加事实
aim_memory_remove_facts- 从记忆中移除特定事实

系统管理

aim_memory_list_stores- 列出所有可用数据库
aim_memory_forget- 忘记特定记忆
aim_memory_unlink- 移除记忆间的连接

📁 智能存储逻辑与文件组织

存储位置优先级

系统按照以下智能逻辑确定存储位置：

项目包含.aim目录- 使用.aim/memory.jsonl（项目本地）
无项目或无.aim目录- 使用配置的全局目录
上下文数据库- 添加后缀：memory-work.jsonl、memory-personal.jsonl

文件组织结构示例

全局设置文件结构：

/Users/yourusername/.aim/ ├── memory.jsonl # 主数据库（默认） ├── memory-work.jsonl # 工作数据库 ├── memory-personal.jsonl # 个人数据库 └── memory-health.jsonl # 健康数据库

项目本地文件结构：

my-project/ ├── .aim/ │ ├── memory.jsonl # 项目主数据库 │ └── memory-work.jsonl # 项目工作数据库 └── src/ └── app.js

💡 最佳实践技巧与使用场景

多设备同步配置

想要在不同设备间同步知识图谱？使用云存储目录实现无缝同步：

{ "mcpServers": { "Aim-Memory-Bank": { "command": "npx", "args": [ "-y", "mcp-knowledge-graph", "--memory-path", "/Users/yourusername/Dropbox/ai-memory" ] } } }

自动批准读取操作

为了获得更流畅的体验，建议配置自动批准：

{ "autoapprove": [ "aim_memory_search", "aim_memory_get", "aim_memory_read_all", "aim_memory_list_stores" ] }

实际应用场景

项目管理助手

存储项目需求、团队成员信息、进度跟踪，让AI成为你的智能项目助手！

学习笔记系统

构建个人知识体系，连接相关概念，形成完整的知识网络。

个人生活记录

记录重要日期、联系人信息、健康数据，构建个人数字记忆库。

🔧 常见问题解决指南

问题1：文件缺少安全标记

错误信息："File does not contain required _aim safety marker"解决方案：手动创建的JSONL文件需要在第一行添加{"type":"_aim","source":"mcp-knowledge-graph"}安全标记

问题2：记忆存储到意外位置

原因：系统自动检测存储位置检查方法：

检查当前目录是否包含.aim文件夹
使用aim_memory_list_stores查看所有可用数据库和当前位置
使用ls .aim/或ls /Users/yourusername/.aim/查看记忆文件

问题3：数据库过多

解决方法：

手动删除不需要的数据库文件
鼓励AI使用简单一致的数据库名称
记住：主数据库始终可用作为默认选项

📋 系统要求与安装

基本要求

Node.js 18+
兼容MCP协议的AI平台（如Claude Desktop）

安装方法

# 通过npx直接运行（无需安装） npx -y mcp-knowledge-graph # 或克隆仓库本地使用 git clone https://gitcode.com/gh_mirrors/mc/mcp-knowledge-graph cd mcp-knowledge-graph npm install npm run build