Structured Memory

Structured Memory MCP Server

Markdown ファイルを通じて、構造化された分野別のメモリ管理を提供する Model Context Protocol（MCP）サーバーです。特定の分野を中心とした継続的なプロジェクトで、役立つコンテキストを時間をかけて蓄積したい場合に特に便利です。旅行の計画、研究プロジェクト、不動産探し、投資の見通し、製品の企画、キャリア開発など、特定の分野に焦点を当てた用途が含まれます。

Structured Memory を選ぶ理由

従来の MCP メモリサーバーは、散在する会話の断片をセマンティック検索します。一般的な情報の想起には有効ですが、整理されたカテゴリ別の情報を必要とする、特定のプロジェクトには適していません。

一方、Structured Memory は、時間をかけてスキャン、更新、追跡できる常に更新されるドキュメントを維持します。AI の支援を受けながら、個人用ノートを使うように活用できます。

メモリドキュメントは Markdown ファイルとして保存され、会話から学習して豊富なコンテキストを時間をかけて構築する LLM によって、主に自動更新されます。

典型的な使い方

1. LLM クライアントに、特定のプロジェクト用のメモリドキュメントを作成するよう依頼します Create a new travel advisor memory document and tell me how to use it. This should start empty and grow over time.

2. その分野の会話用に新しいプロジェクトを作成します。提供された使用方法の説明をプロジェクトのコンテキストに追加します

   注：LLM は、ツールのアドバイスに反して、インストール手順を表示しないことがあります。その場合は、LLM にインストール手順を表示するよう追加で依頼すれば、対応してくれるはずです。

3. 新しいチャットで会話を始める際は、まずプロジェクトのメモリから利用可能な情報を確認します。LLM は時間をかけてこのメモリを更新し、役立つコンテキストを蓄積します。

4. 必要に応じて、LLM にメモリファイルの追加や調整を依頼できます。また、関連情報を引き出す質問をするよう LLM に依頼するのも便利です（例：「旅行の好みを知るために、いくつか質問してください」）。

インストール

オプション 1：npm からインストール（公開後）

npm install -g @nmeierpolys/mcp-structured-memory

オプション 2：ソースからインストール

git clone https://github.com/nmeierpolys/mcp-structured-memory.git
cd mcp-structured-memory
npm install
npm run build

設定

Claude Desktop の場合

claude_desktop_config.json ファイルを編集し、次のエントリを追加します。

{
  "mcpServers": {
    "mcp-structured-memory": {
      "command": "npx",
      "args": ["@nmeierpolys/mcp-structured-memory"]
    }
  }
}

利用可能なツール

• create_memory - 初期コンテンツを指定して、新しいメモリドキュメントを作成します
• list_memories - 利用可能なすべてのメモリドキュメントを一覧表示します
• get_memory_summary - メモリドキュメントの概要を取得します
• get_section - メモリドキュメントの特定のセクションを取得します
• get_full_memory - メモリドキュメントの全内容を取得します
• search_within_memory - メモリドキュメント内の情報を検索します
• update_section - メモリドキュメントのセクション全体を更新します
• add_to_list - リスト形式のセクションに項目を追加します
• update_list_item - リスト内の既存の項目を更新します
• move_list_item - リスト内の項目を別のセクションに移動します

柔軟な構成

メモリドキュメントは、必要に応じたあらゆる構成に対応します。AI が用途に合わせてセクションを整理します。一般的な例：

• 旅行の計画：目的地、旅程、宿泊先、アクティビティ、レストラン、旅行のヒント、予算トラッカー
• 研究プロジェクト：研究課題、文献レビュー、方法論、調査結果、データソース、次のステップ
• 不動産探し：検索条件、売り出し中の物件、内見した物件、見送った物件、市場に関する知見、不動産エージェントの連絡先

例：メモリの自動構築

User: "Create a new Minnesota trip memory document and tell me how to use it. This should start empty and grow over time."

Claude: "I've created a travel memory document for your Minnesota trip. As we discuss your plans, I'll automatically update it with destinations, timing, preferences, and other details I learn about your trip."

User: "I want to see fall colors, go hiking, try local cuisine, and visit both the North Shore and the Twin Cities."

Claude: "I've noted your priorities in the memory: fall foliage viewing, hiking opportunities, local restaurants, North Shore destinations, and Twin Cities attractions. I'll keep track of specific recommendations as we explore options."

[Later conversation]
User: "What hiking trails have good fall colors?"

Claude: "Based on our previous discussions, I see you're focused on fall colors in Minnesota. Let me suggest some trails and I'll add the best ones to your travel memory..."

バックアップとバージョン管理

サーバーは、大規模な更新の前にタイムスタンプ付きのバックアップを自動的に作成します。

ストレージの保存場所

メモリドキュメントのファイルは、次の場所に Markdown ファイルとして保存されます。

• macOS：~/Library/Application Support/mcp-structured-memory/
• Windows：%LOCALAPPDATA%\mcp-structured-memory\
• Linux：~/.local/share/mcp-structured-memory/