Category-based Memory Server

カテゴリベースのメモリーサーバー

カテゴリベースのメモリーシステムを使用した、永続メモリーの基本的な実装です。カテゴリ分けされたメモリーエントリーを保存することで、Claude がチャットをまたいで情報を記憶できるようになります。

中核となる概念

カテゴリ

カテゴリは、メモリーシステムにおける主要な整理単位です。各カテゴリには、メモリー（情報の断片）がまとめて格納されます。

例：

"development": [
  "Uses pnpm for package management",
  "Prefers 2-space indentation"
]

タグ

タグは、カテゴリ内のメモリーに追加のコンテキストとグループ分けを提供します。関連するメモリーの絞り込みや検索に使用できます。

例：

# formatting style
Uses 2-space indentation
Prefers camelCase for variables

グローバルメモリーとローカルメモリー

メモリーシステムは、次の2つの保存先に対応しています。

• グローバルメモリー：ユーザーのホームディレクトリ（~/.config/mcp-memory）に保存され、すべてのプロジェクトで利用できます。
• ローカルメモリー：現在のプロジェクトディレクトリ（.mcp-memory）に保存され、現在のプロジェクトでのみ利用できます。

メモリーの保存

メモリーはテキストエントリーとして保存され、次のような特徴があります。

• カテゴリごとに整理されます（別々のファイルに保存されます）
• 検索しやすいようにタグを付けられます
• プレーンテキストファイルに保存されます
• 個別に追加または削除できます
• アトミックである必要があります（メモリー1つにつき情報は1つ）

メモリーファイルの例（development.txt）：

# formatting style
Uses 2-space indentation
Prefers camelCase for variables

# tools
Uses eslint for linting
Uses prettier for formatting

API

ツール

• remember_memory

  • 指定したカテゴリに、任意のタグを付けてメモリーを保存します
  • 入力：
    • category（文字列）：メモリーを保存するカテゴリ
    • data（文字列）：メモリーに保存するデータ
    • tags（文字列配列、任意）：メモリーを分類するための任意のタグ
    • is_global（ブール値）：グローバルメモリーとローカルメモリーのどちらに保存するか
  • 任意のタグとともに、指定したカテゴリにメモリーエントリーを保存します

• retrieve_memories

  • 指定したカテゴリからすべてのメモリーを取得します
  • 入力：
    • category（文字列）：メモリーを取得するカテゴリ。すべてのカテゴリを対象にする場合は「*」を指定します
    • is_global（ブール値）：グローバルメモリーとローカルメモリーのどちらから取得するか
  • 指定したカテゴリのメモリーをタグごとにまとめて返します
  • カテゴリが存在しない場合は空のオブジェクトを返します

• remove_memory_category

  • 指定したカテゴリ内のすべてのメモリーを削除します
  • 入力：
    • category（文字列）：削除するカテゴリ。すべてのカテゴリを対象にする場合は「*」を指定します
    • is_global（ブール値）：グローバルメモリーとローカルメモリーのどちらから削除するか
  • カテゴリファイル全体を削除します
  • カテゴリが存在しない場合は何もせずに終了します

• remove_specific_memory

  • 指定したカテゴリ内の特定のメモリーを削除します
  • 入力：
    • category（文字列）：削除するメモリーを含むカテゴリ
    • memory_content（文字列）：削除するメモリーの内容（一部一致）
    • is_global（ブール値）：グローバルメモリーとローカルメモリーのどちらから削除するか
  • 指定した内容を含むメモリーを削除します
  • メモリーが存在しない場合は何もせずに終了します

Claude Desktop での使用方法

セットアップ

次の内容を claude_desktop_config.json に追加してください。

npx

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@mkusaka/mcp-server-memory"
      ]
    }
  }
}

カスタム設定を使用した npx

次の環境変数を使用して、サーバーを設定できます。

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@mkusaka/mcp-server-memory"
      ],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
      }
    }
  }
}

• MEMORY_FILE_PATH：メモリー保存用 JSON ファイルへのパス（デフォルト：サーバーディレクトリ内の memory.json）

VS Code のインストール手順

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用してください。

手動でインストールするには、次の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加してください。Ctrl + Shift + P を押して Preferences: Open Settings (JSON) と入力すると開けます。

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

.vscode/mcp.json ファイルでは mcp キーは不要です。

npx

{
  "mcp": {
    "servers": {
      "memory": {
        "command": "npx",
        "args": [
          "-y",
          "@mkusaka/mcp-server-memory"
        ]
      }
    }
  }
}

ライセンス

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