Knowledge Graph Memory Server

基本能力

产品定位

mcp-memory-py 是一个基于本地知识图谱的持久化记忆服务器，旨在帮助 Claude（AI模型）跨聊天会话记住用户信息。

核心功能

1. 实体管理：创建、删除和查询实体（如人物、组织、事件等）。
2. 关系管理：定义和管理实体之间的有向关系（如“works_at”）。
3. 观察管理：添加、删除和查询实体的观察信息（如“Speaks fluent Spanish”）。
4. 知识图谱查询：支持全文搜索和特定节点查询。

适用场景

1. 个性化聊天：记住用户的基本信息、偏好和行为模式。
2. 信息管理：存储和检索结构化信息，如人物关系、事件记录等。
3. 知识图谱构建：用于构建和维护本地知识库。

工具列表

1. create_entities：创建多个新实体。
2. create_relations：创建实体之间的关系。
3. add_observations：向实体添加观察信息。
4. delete_entities：删除实体及其关联关系。
5. delete_observations：删除实体的观察信息。
6. delete_relations：删除实体之间的关系。
7. read_graph：读取整个知识图谱。
8. search_nodes：基于查询搜索节点。
9. open_nodes：按名称检索特定节点。

常见问题解答

1. 如何设置存储路径：通过环境变量 MEMORY_FILE_PATH 指定自定义的 JSON 文件路径。
2. 如何启用调试日志：设置环境变量 DEBUG_LOGGING 以生成每日日志文件。
3. 如何处理重复实体或关系：工具会自动忽略重复的实体或关系。

使用教程

使用依赖

1. 确保已安装 Python 和 uvx 工具。
2. 安装依赖： bash pip install -r requirements.txt

安装教程

1. 克隆项目仓库。
2. 配置 claude_desktop_config.json 文件，添加以下内容： json { "mcpServers": { "memory-python": { "command": "uvx", "args": [ "--refresh", "--quiet", "mcp-memory-py" ], "env": { "MEMORY_FILE_PATH": "/path/to/custom/memory.json" } } } }
3. 启动服务： bash uvx mcp-memory-py

调试方式

1. 运行单元测试： bash uv run pytest
2. 使用 MCP Inspector 调试： bash npx @modelcontextprotocol/inspector uv run --directory src -m mcp_memory_py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。