MCP Memory Py

🚀 知识图谱内存服务器

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

🚀 快速开始

在Claude Desktop中设置

uv run pytest

调试使用MCP Inspector

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

✨ 主要特性

• 借助本地知识图实现持久记忆，让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): 观察内容

📄 许可证

此MCP服务器根据MIT许可证发布。这意味着您可以自由地使用、修改和分发软件，但需遵守MIT许可证的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。