基本能力
产品定位
Memory MCP Server 是一个知识图谱管理服务,专注于在内存中维护和管理实体、关系及观察数据,适用于需要高效、结构化数据管理的应用场景。
核心功能
- 实体管理:支持创建、查询、更新和删除实体,实体类型包括 person、concept、project、document、tool、organization、location 和 event。
- 关系管理:支持创建和删除实体之间的关系,关系类型包括 knows、contains、uses、created、belongs-to、depends-on 和 related-to。
- 观察数据管理:支持为实体添加观察数据,观察数据需为唯一且非空的字符串。
- 搜索功能:支持自然语言查询,支持模糊匹配和加权搜索。
- 数据验证:提供严格的验证规则,确保实体名称、类型、观察数据和关系的合法性。
适用场景
- 知识管理:用于管理项目、文档、人员等结构化知识。
- 数据建模:适用于需要构建复杂关系网络的应用,如社交网络分析、依赖关系管理。
- 开发工具:可作为开发工具的一部分,用于管理开发过程中的实体和关系。
工具列表
- get_entity:查询指定实体。
- get_graph:获取整个知识图谱数据。
- create_entities:创建多个实体。
- add_observation:为实体添加观察数据。
- create_relation:创建实体之间的关系。
- search_memory:执行自然语言搜索。
- delete_entities:删除指定实体。
- delete_relation:删除实体之间的关系。
- flush_memory:清空内存中的所有数据。
常见问题解答
- 实体名称无效:确保实体名称以小写字母开头,仅包含小写字母、数字和连字符,且长度不超过100字符。
- 关系创建失败:确保源实体和目标实体存在,且关系类型为预定义类型。
- 观察数据重复:确保每个实体的观察数据唯一。
使用教程
使用依赖
无特殊依赖,直接通过 MCP 协议安装。
安装教程
bash
mcp install main.py -v MEMORY_FILE_PATH=/path/to/memory.jsonl
调试方式
- 运行测试:
bash
pytest tests/ - 添加新功能:
- 更新
validation.py
中的验证规则。 - 在
tests/test_validation.py
中添加测试。 - 在
knowledge_graph_manager.py
中实现变更。