Claude Memory MCP

🚀 Claude Memory MCP Server - Claudeデスクトップアプリ用の大規模言語モデル持続的メモリサーバー

このプロジェクトは、広範な研究に基づく最適化されたメモリ技術を実装し、大規模言語モデルに持続的なメモリ機能を提供し、Claudeデスクトップアプリケーションと特別に統合されています。

✨ 主な機能

• 階層型メモリアーキテクチャ：短期、長期、アーカイブのメモリ層があります。
• 複数のメモリタイプ：会話、知識、エンティティ、反省などのメモリをサポートします。
• 意味検索：意味の類似性に基づいてメモリを検索します。
• メモリの統合：短期メモリを自動的に長期メモリに統合します。
• メモリ管理：重要度に基づいてメモリを保持または忘れます。
• Claude統合：Claudeデスクトップアプリケーションで直接使用できます。
• MCPプロトコルサポート：Model Context Protocolと互換性があります。

📚 詳細ドキュメント

アーキテクチャ

MCPサーバーは機能ドメインベースのアーキテクチャを採用しており、以下のコンポーネントを含んでいます。

┌─────────────────────────────────────────────────────────┐
│                   Claude デスクトップ                        │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                     MCP インターフェース                       │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────┐ │
│  │ ツール定義         │  │ リクエストハンドラー     │  │ セキュリティ   │ │
│  └─────────────────┘  └─────────────────┘  └──────────┘ │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                メモリドメインマネージャー                    │
├─────────────────┬─────────────────┬────────────────────┤
│  連続メモリ領域   │  意味領域       │  時間領域          │
├─────────────────┴─────────────────┴─────────────────────┤
└                                                ┓

インストール

1. リポジトリをクローンする：

git clone [repository-url]
cd claude-memory-mcp-server

2. 依存関係をインストールする：

pip install -r requirements.txt

3. サーバーを起動する：

python mcp/server.py

Claude Desktopとの統合

Claude Desktopの設定ファイルに以下の内容を追加します。

{
    "mcp_server": {
        "host": "localhost",
        "port": 5000,
        "memory_file_path": "path/to/memory.json"
    }
}

メモリファイル構造

メモリデータはJSON形式で保存され、以下のような例があります。

{
    "metadata": {
        "version": "1.0.0",
        "timestamp": "2023-10-26T12:00:00Z"
    },
    "memory_entries": [
        {
            "id": 1,
            "content": "今日の天気は良いです。公園へ散歩に行きましょう。",
            "context": ["weather", "park"],
            "timestamp": "2023-10-26T12:05:00Z"
        },
        {
            "id": 2,
            "content": "傘を持っていってください。午後に雨が降るかもしれません。",
            "context": ["weather", "umbrella"],
            "timestamp": "2023-10-26T12:10:00Z"
        }
    ]
}

使用方法

サーバーを実行する

python mcp/server.py

利用可能なツール

• メモリをクエリする：query_memory
• メモリを更新する：update_memory
• メモリエントリを削除する：delete_memory_entry

プロジェクト構造

claude-memory-mcp-server/
├── mcp/
│   ├── server.py          # MCPサーバーの実装
│   ├── tools.py           # MCPツールの定義
│   └── handler.py         # リクエストハンドラー
├── security/
│   └── validation.py      # 入力検証
└── utils/
    ├── embeddings.py      # ベクトル埋め込みツール
    └── schema.py          # スキーマ検証

テストの実行

pytest

研究背景

この実装は、広範な研究に基づく大規模言語モデルの持続的メモリ技術に基づいています。

• オペレーティングシステムのヒューリスティックメモリ管理：MemGPTのような階層型メモリアーキテクチャに似ています。
• 生物学的な連続メモリ：コンテキストに敏感なメモリ検索です。
• ベクトル埋め込み：意味検索はベクトルデータベースの方法から着想を得ています。
• 自己反省：定期的な振り返りによってメモリを統合します。

貢献ガイド

貢献を歓迎します！自由にPull Requestを提出してください。

📄 ライセンス

このプロジェクトはMIT Licenseの下でオープンソース化されています。詳細はLICENSEファイルを参照してください。

謝辞

• 大規模言語モデルの最適化メモリ技術の研究に基づいています。
• Claudeと統合するためにModel Context Protocolを実装しています。