Memory MCP Server

Memory MCP サーバー

ナレッジグラフの形式でメモリを処理、保存する MCP サーバーの Python 実装です。

概要

MCP Server Memory は、AI メモリ用の永続的なナレッジグラフを維持する機能を提供します。エンティティ、関係、観察事項の形式で構造化データを保存、取得、検索できます。これにより、AI システムはセッションをまたいで情報を保存し、思い出すことができます。

機能

• 構造化情報を持つエンティティを作成、管理する
• エンティティ間に型付きの関係を設定する
• 既存のエンティティに観察事項を追加する
• エンティティ、関係、観察事項を削除する
• ナレッジグラフ内のノードを検索する
• 名前で特定のノードを取得する

ツール

サーバーは MCP（Model Context Protocol）インターフェースを実装し、以下のツールを公開します。

• create_entities：ナレッジグラフに複数の新しいエンティティを作成する
• create_relations：エンティティ間に複数の新しい関係を作成する
• add_observations：既存のエンティティに新しい観察事項を追加する
• delete_entities：エンティティと関連する関係を削除する
• delete_observations：エンティティから特定の観察事項を削除する
• delete_relations：グラフから特定の関係を削除する
• read_graph：ナレッジグラフ全体を読み取る
• search_nodes：クエリに一致するノードを検索する
• open_nodes：名前で特定のノードを取得する

インストール

uv を使用する場合（推奨）

uv add mcp-server-memory

pip を使用する場合

pip install mcp-server-memory

使用方法

サーバーの実行

# Run the server directly
mcp-server-memory

# Set custom memory file path
MEMORY_FILE_PATH=/path/to/memory.json mcp-server-memory

設定

MCP クライアント向けの設定

Claude（claude_desktop_config.json）または Cursor（mcp.json）の設定ファイルに追加します。

"mcpServers": {
  "memory": {
    "command": "/path/to/uv",
    "args": [
      "--directory",
      "/path/to/mcp_server_memory/src",
      "run",
      "python",
      "-m",
      "mcp_server_memory"
    ],
    "env": {
      "MEMORY_FILE_PATH": "/path/to/memory.json"
    }
  }
}

"mcpServers": {
  "memory": {
    "command": "python",
    "args": ["-m", "mcp_server_memory"]
  }
}

メモリパスの設定

デフォルトでは、ナレッジグラフのデータはパッケージディレクトリ内の memory.json ファイルに保存されます。MEMORY_FILE_PATH 環境変数を使用して、保存場所をカスタマイズできます。

開発

リポジトリをクローンし、開発用の依存関係をインストールします。

git clone https://github.com/jcdiv47/mcp-server-memory.git
cd mcp-server-memory
uv venv
source .venv/bin/activate
uv install -e ".[dev]"

ライセンス

mcp-server-memory は MIT License の下でライセンスされています。つまり、MIT License の利用規約に従う限り、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。