Optimized Memory MCP Server

🚀 メモリ最適化MCPサーバー

このプロジェクトは、Claude AIのプログラミング能力、および良好なAIワークフローとプロンプト設計をテストおよびデモンストレーションするためのものです。これは、Pythonベースのローカル知識グラフメモリMCPサーバー（公式実装はJavaで書かれていると思われます）のブランチで、SQLiteをバックエンドとして使用しています。

📚 知識グラフメモリサーバー

基本的な知識グラフの永続化メモリ実装です。これにより、Claudeはチャット中のユーザー情報を記憶することができます。

🌟 核心概念

🔘 エンティティ

エンティティは知識グラフの主要なノードです。各エンティティには以下があります：

• 一意の名前（識別子）
• エンティティタイプ（例：「人」、「組織」、「イベント」）
• 観測結果のリスト

例：

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

🔗 関係

関係はエンティティ間の方向性のある接続を定義します。常に能動態で保存され、エンティティがどのように相互作用または関連付けられているかを説明します。

例：

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

📋 観測結果

観測結果はエンティティに関する個別の情報断片です。以下の特性があります：

• 文字列形式で保存される
• 特定のエンティティに付加される
• 独立して追加または削除できる
• 原子化されている（各観測結果は1つの事実を表す）

例：

{
  "entityName": "John_Smith",
  "observations": [
    "会说流利的西班牙语",
    "2019年毕业",
    "喜欢早晨会议"
  ]
}

📄 API

🛠 ツール

エンティティ管理

• getEntities(): すべてのエンティティを取得します。
• addEntity(entity): 新しいエンティティを追加します。
• updateEntity(entityId, updates): 指定されたエンティティの属性を更新します。

関係管理

• getRelations(): すべての関係を取得します。
• addRelation(relation): 新しい関係を追加します。
• removeRelation(relationId): 指定された関係を削除します。

観測結果管理

• getObservations entityId: 指定されたエンティティのすべての観測結果を取得します。
• addObservation(entityId, observation): 指定されたエンティティに新しい観測結果を追加します。
• updateObservation(observationId, updates): 指定された観測結果を更新します。

💻 使用ガイド

チャット開始時に、Claudeは自動的にすべての関連メモリを検索し、「正在回忆...」で始まるメッセージでユーザーに通知します。会話全体を通じて、Claudeは新しい情報を収集し、知識グラフに更新します。

💡 プロンプト設計

具体的な使用シナリオに合わせてプロンプト内容を調整することをおすすめします。これにより、モデルがメモリの頻度とタイプを決定できます。以下は、チャットのカスタマイズに使用できるプロンプトの例です：

各インタラクションは以下の手順で行います：

1. ユーザー識別：
   - default_userとの会話を想定します。
   - default_userが未確定の場合は、自動的に識別を試みます。

2. メモリ検索：
   - 常に「正在回忆...」から始め、知識グラフからすべての関連情報を検索します。
   - 知識グラフを「メモリ」と呼びます。

3. メモリ内容：
   - ユーザーとのやり取り中に、以下のカテゴリの新しい情報を収集します：
     a) 基本的な人格（年齢、性別、所在地、職位、学歴など）
     b) 行動（趣味、習慣など）
     c) 好み（コミュニケーションスタイル、使用言語など）
     d) 目標（目的、目標、抱負など）
     e) 関係（個人および職業上の関係、3度の分離まで）

4. メモリ更新：
   - インタラクション中に新しい情報を収集した場合は、以下のようにメモリを更新します：
     a) 繰り返し出現する組織、人物、重要なイベントに対してエンティティを作成します。
     b) 関係を使用して、それらを現在のエンティティに接続します。
     c) それらに関する事実を観測結果として保存します。

🛠 ビルド

Dockerを使用する場合：

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

📄 ライセンス

このMCPサーバーはMITライセンスの下で配布されています。これは、MITライセンスの条項と条件に従う限り、自由に使用、変更、および配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。