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文件。