MCP Memory Py

🚀 知识图谱内存服务器

本项目是一个基于本地知识图实现持久记忆的基础方案，借助它Claude能够记住不同聊天场景下用户的信息。此外，它还是原始参考服务器（版本0.6.3）的Python端口，开发过程中借助Cline和Claude Sonnet 3.5的协助进行了代码重构与优化。

✨ 主要特性

• 实现持久记忆：利用本地知识图，让Claude记住用户在不同聊天中的信息。
• 代码优化：参考原始服务器进行Python端口开发，并进行了代码重构与优化。

📚 详细文档

核心概念

实体

实体作为知识图的主要节点，具备以下属性：

• 唯一名称（标识符）
• 实体类型（例如，“人”，“组织”，“事件”）
• 观察列表

示例：

{
  "name": "John_Smith",
  "entityType": "person",
  "observations": ["讲流利西班牙语"]
}

关系

关系用于定义实体之间的定向连接，以主动语态存储，描述实体间的相互作用或关联。

示例：

{
  "from": "John_Smith",
  "to": "Anthropic",
  "relationType": "works_at"
}

观察

观察是关于实体的离散信息片段，具有以下特点：

• 以字符串形式存储
• 附加到特定实体
• 可独立添加或修改
• 用于记录事实

API 函数

create_entity

创建一个新的实体。

参数：

• entity_type (str): 实体类型（例如，“人”，“组织”）
• name (str): 实体名称

返回值：

• 新创建的实体对象

add_relation

向知识图中添加一个关系。

参数：

• from_entity (str): 关系起点的实体ID
• to_entity (str): 关系终点的实体ID
• relation_type (str): 关系类型（例如，“工作于”，“位于”）

add_observation

向知识图添加一个观察。

参数：

• entity_id (str): 观察所属的实体ID
• observation (str): 观察内容

💻 使用示例

基础用法

在Claude Desktop中设置

uv run pytest

调试使用MCP Inspector

npx @modelcontextprotocol/inspector uv run --directory src -m mcp_memory_py

📄 许可证

此MCP服务器依据MIT许可证发布。您可自由使用、修改和分发该软件，但需遵循MIT许可证的条款和条件。详细信息请查阅项目仓库中的LICENSE文件。