memory-mcp

永続的なエージェントメモリのためのスタンドアロンMCPサーバー — 短期/長期の階層、測定可能な信頼性、ライフサイクルメンテナンスを備え、バックエンドは SQLite (FTS5 + sqlite-vec) とローカル MiniLM 埋め込みです。外部サービスや API キーは不要です。

要件

• Node.js >= 22

• このパッケージはコンパイル済みの JavaScript を同梱しているため、実行時に TypeScript ツールチェーンは不要です。

Related MCP server: localmem-mcp

インストール

npm install @jommar/memory-mcp

2つの実行ファイルが提供されています。

クイックスタート

stdio（デフォルト）

MCPクライアントにサーバーバイナリを指定します。

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server"
    }
  }
}

または直接実行します。

memory-mcp-server

npx を使用する場合は、サーバーのバイナリを明示的に選択します（初回使用時にパッケージがインストールされます）。

npx -y -p @jommar/memory-mcp memory-mcp-server

HTTP（localhostのみ）

MEMORY_TRANSPORT=http memory-mcp-server

HTTPエンドポイントはデフォルトで 127.0.0.1:3000 にバインドし、モダン (2026-07-28) とレガシー (2025-11-25) の両方のプロトコルリビジョンを同じエンドポイントから提供するため、あらゆる MCP クライアントが接続できます。サーバーはステートレスです — セッションIDは不要です。

初回実行

ストアは ~/.memory-mcp/memory.db に自動的に作成されます。埋め込みはオフライン優先です。オプトインしない限り、モデルはダウンロードされません。

# opt in to the one-time model download (about 23 MB, MiniLM-L6, q8 quantized)
MEMORY_EMBEDDING_OFFLINE=false memory-mcp-server

モデルが利用可能になるまでは、remember と recall は引き続き動作します — キーワード検索のみにフォールバックします。モデル導入後は、CLI の reindex を使用してベクトルをバックフィルしてください。

設定

すべての設定は MEMORY_* 環境変数で行います（設定ファイルはありません）。

ツール

10個のツールが登録されています: remember、recall、get、update、forget、list、confirm、contradict、promote、consolidate。入力と動作の完全なリファレンスは docs/tools.md を参照してください。

remember は interactive オプトインを受け付けます。ほぼ重複したエントリを検出すると、クライアントにマージまたは作成（MRTR）を要求でき、インタラクティブサポートのないクライアントではグレースフルデグラデーションします。

メンテナンスCLI

memory-mcp export ./out      # write every memory as a markdown frontmatter file
memory-mcp import ./staging  # validate, then import (never overwrites existing keys)
memory-mcp reindex           # rebuild FTS + vector indexes from stored content
memory-mcp stats             # print store counts

ドキュメント

• docs/tools.md — ツールリファレンス

• docs/reliability.md — 信頼性モデルとライフサイクルルール（consolidate の背後にあるレポート専用メンテナンスエンジン）

ライセンス

MIT — LICENSE を参照してください。