MCP Memory Py

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

このサーバーは、ローカルの知識グラフを用いて永続的な記憶を実現する基本的な実装です。Claudeが異なるチャットでのユーザー情報を記憶できるようになります。

これはオリジナルのリファレンスサーバー（バージョン0.6.3）のPythonポートです。私はこの機会に、主にClineとClaude Sonnet 3.5の支援を受けて、いくつかのコードリファクタリングを行いました。

🚀 クイックスタート

この知識グラフメモリサーバーを使用することで、Claudeがユーザー情報を異なるチャットで記憶できるようになります。以下に、API関数や使用方法を紹介します。

✨ 主な機能

• ローカルの知識グラフを使用して、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): 関係のタイプ（例：「work_at」、「located_at」）

add_observation

知識グラフに観測を追加します。

パラメータ：

• entity_id (str): 観測が属するエンティティID
• observation (str): 観測内容

💻 使用例

基本的な使用法

Claude Desktopでの設定：

uv run pytest

高度な使用法

MCP Inspectorを使用したデバッグ：

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

📄 ライセンス

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