MCP Memory Server

🚀 知識圖譜內存服務器

本項目是一個基本的知識圖譜持久化內存實現，藉助本地知識圖譜，讓Claude能夠記住用戶在聊天中的信息。需注意，該項目是從 modelcontextprotocol/servers 提取出來以創建獨立實現。

🚀 快速開始

作為獨立包使用

安裝依賴：

npm install mcp-memory-server

運行命令：

npx mcp-memory-server

Docker 部署

構建鏡像：

docker build -t mcp/memory -f src/Dockerfile .

✨ 主要特性

• 實現知識圖譜的持久化內存存儲。
• 支持Claude記住用戶聊天信息。
• 提供創建、查詢、更新和刪除實體的API。

📚 詳細文檔

核心概念

實體

實體是知識圖譜中的核心元素，每個實體都有一個唯一的標識符和一組屬性。

• 結構：
  • id：唯一標識符。
  • type：類型（例如：人、組織、地點等）。
  • properties：屬性，包括：
    • name：名稱
    • description：描述
    • relations：關係列表
• 示例：

{
  "id": "user_123",
  "type": "person",
  "properties": {
    "name": "張三",
    "age": 30,
    "job": "軟件工程師"
  }
}

關係

關係表示實體之間的連接，具有方向性和權重。

• 結構：
  • id：唯一標識符。
  • from：源實體ID。
  • to：目標實體ID。
  • type：類型（例如：knows, works_at, lives_in）。
  • weight：權重（默認為1）。
• 示例：

{
  "id": "relation_456",
  "from": "user_123",
  "to": "company_789",
  "type": "works_at",
  "weight": 0.8
}

API

創建實體

async createEntity(properties) => Entity

• 參數：
  • properties：實體屬性。
• 返回：新創建的實體對象。

查詢實體

async getEntity entityId => Optional<Entity>

• 參數：
  • entityId：實體ID。
• 返回：如果存在，則返回實體；否則返回 null。

更新實體

async updateEntity entityId, properties => Entity

• 參數：
  • entityId：實體ID。
  • properties：新屬性。
• 返回：更新後的實體對象。

刪除實體

async deleteEntity entityId => boolean

• 參數：
  • entityId：實體ID。
• 返回：刪除成功則返回 true，否則 false。

📄 許可證

本 MCP 服務器根據 MIT 許可證發佈。這意味著你可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。更多詳細信息，請參見項目存儲庫中的 LICENSE 文件。

系統提示示例（用於 Claude 的自定義指令）

遵循以下步驟進行每次交互：

1. 用戶識別：
   - 假設你正在與 default_user 互動
   - 如果尚未確定 default_user，請主動嘗試識別

2. 內存檢索：
   - 總是從說“Remembering...”開始，從知識圖譜中檢索所有相關信息
   - 將你的知識圖譜稱為“memory”

3. 內存：
   - 在與用戶交流時，注意任何新信息，包括以下類別：
     a) 基本人格（年齡、性別、位置、職位、教育水平等）
     b) 行為（興趣、習慣等）
     c) 偏好（溝通風格、首選語言等）
     d) 目標（目標、目標、抱負等）
     e) 關係（個人和職業關係，最多三級）

4. 內存更新：
   - 如果在交互中收集到任何新信息，請按以下方式更新內存：
     a) 為重複出現的組織、人物和重要事件創建實體
     b) 使用關係將它們與當前實體連接
     c) 將事實存儲為觀察結果