mcpField
A

agentic-recall

ローカル
github.comメモリ・ナレッジ
公式サイト

agentic-recall について

エージェントタスク向けの長期メモリ。わからないときはそのことを伝えます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "dfrancislyondflabc-tech-agentic-recall": {
      "command": "npx",
      "args": [
        "-y",
        "agentic-recall"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "MEMORY_ROOT": "<MEMORY_ROOT>"
      }
    }
  }
}
起動コマンドnpx -y agentic-recall
設定が必要な環境変数
MEMORY_DIRAbsolute path to the folder holding your markdown memories. Required — the server never searches your disk for it.
MEMORY_ROOTOptional. Where the embedding model cache, vector cache and indexes are kept. Defaults beside the code for a clone, ~/.agentic-recall for a package install.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmagentic-recall2.1.5

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
drybooleanいいえimport：インポートされる内容を正確に報告し、何も書き込みません。
runbooleanいいえprobe_status：前回の sidecar を読み込まず、今すぐスイープを実行します。プローブは検索パス上では実行されません。
backintegerいいえthread：アンカーより前に返す会話の往復数（デフォルトは 0）。
namestringいいえget/neighbors/demote/promote：メモリ名（.md を除いたファイル名）。
nearstringいいえsearch：ソフトな時間アンカー（ISO）。その期間のランキングの重みを高めますが、期間外の内容も表示されます。
pathstringいいえimport：取り込むメモリファイルまたはフォルダーの絶対パス。md/txt/rtf/doc/docx/odt/html/pdf/csv/json/zip を読み込みます。ChatGPT のエクスポート（conversations.json またはその .zip）を認識し、会話ツリーを順にたどります。
textstringいいえverify：メモリを指定する代わりに、commit SHA をスキャンする未加工のテキスト。
waitbooleanいいえindex：jobId を返す代わりに、ビルドが完了するまで待機します。数分待てる呼び出し元のみ使用してください。MCP 経由のブロッキングインデックスはタイムアウトしたため、デフォルトは非同期です。
afterstringいいえsearch：メモリの日付（ISO）のハード下限。これより前を除外します。除外する場合にのみ使用してください。
briefbooleanいいえget：テキストとその出所（名前、パス、本文、切り詰められた内容）のみを返し、約 25 個の来歴・鮮度フィールドは返しません。このメモリを読むと決めていて、内容だけが必要な場合に使います。たとえば、不在に関する注記に従って bestWeak[0] を開く場合です。search/latest：各 ROW について name/corpus/score/snippet/provenance とタイムスタンプのみを返します。path、type、description、個別のスコア、thread position、verified commits は返しません。ENVELOPE は変更されず、indexStale、staleWarning、recencyVoid、recentUnindexed、uncapturedSessions、captureHealth、configWarning、guidance はすべて引き続き返されます。brief が行を簡略化するだけで、注意事項を削らないためです。広い範囲の scope:'all' を検索し、その後 `get` で結果を 1、2 件開く場合に使用します。
forcebooleanいいえindex：インクリメンタルキャッシュを無視し、すべてのファイルを再度埋め込みます。
jobIdstringいいえindex_status：index が返したジョブ ID。
limitintegerいいえsearch：結果の最大数（デフォルトは 8）。latest：デフォルトは 5、ブラウズモード（クエリなし）では 10。sessions：会話数（デフォルトは 20）。
querystringいいえsearch：自然言語のクエリ。latest：絞り込み語句。範囲内の最新ドキュメントをブラウズする場合は省略してください。
scopeanyいいえsearch/latest：検索するコーパス。単一の名前、または任意の名前を組み合わせた ARRAY を指定します。ワークコーパス：'curated'（デフォルト）= THIS プロジェクトのメモリフォルダーにある手書きメモリ、'projects' = OTHER プロジェクトのメモリフォルダーにある手書きメモリ（同種の内容、ホット層、書き込み可能。他のプロジェクトにメモリがある場合、デフォルトでスコープ拡大によりアクセス）、'staging' = 自動取り込みされた会話のやり取り、'handoff' = メモリフォルダー外から読み取り専用でインデックス化された機関の HANDOFF/PHASE ドキュメント（「X の引き継ぎ時の状態」を調べる場合に使用）。'all' = ワークコーパスのみを個別セクションで返します。search ではランキング済みのセクションが .groups に、latest ではコーパスごとに時間順のセクションが .sections に返され、それぞれが独自の `orderedBy` を宣言します。curated ファイルにはタイムスタンプがなく、mtime の順序は記録上のもので、時系列ではないためです。LIBRARY カテゴリ（書籍、マニュアル、ポリシーなどのインポート済み参考資料。memory-library/ 内の各ディレクトリ）は、名前（'books'、['all','books']）を指定するか、'everything'（= ワーク + すべてのカテゴリ）を使用した場合にのみ検索されます。設計上、'all' や自動ルーティングには含まれず、インポートした内容がワーク検索を薄めることはありません。不明な名前はエラーとなり、利用可能な名前が一覧表示されます。各コーパスは独自のインデックスと統計を持ち、混合すると再現率が実測で低下するため、決して混合されません。省略すると、文言に基づいて選択されます（scopeHint に表示）。`index` アクションでは、再構築するインデックスを選択します。デフォルトは curated + projects + handoff です（staging は取り込み駆動でコストが高く、ライブラリカテゴリは名前を指定するか 'everything' を使った場合に再構築されます）。
actionenumはい実行する読み取り操作。このツールはメモリフォルダーに書き込みません。インポート、キャプチャ、インデックス作成、降格、昇格には memory_write を使用してください。search | latest | sessions | thread | verify | index_status | get | neighbors | probe_status
beforestringいいえsearch：メモリの日付（ISO）のハード上限。これより後を除外します。
domainenumいいえ任意ですが、分かっている場合は指定する価値があります。これらのメモリが扱う作業の種類です。カウントで区別できるのはコードと非コードのみです。小説、事業計画、日程管理は統計上同一のため、執筆・ビジネス・研究・計画の助言を分けるにはこれしかありません。指定された値は信頼できるものとして扱い、省略時はコーパスから推定します。code | writing | business | research | planning | prose | mixed
expandanyいいえsearch のみ：この呼び出しでのクエリ拡張。'on'（デフォルト：`queries` をランキングし、拒否された質問には言い換えて再試行するよう促す）、'shadow'（計算して記録するが、結果は変更しない）、'off'（機能を完全に無効化し、何も追加・記録しない）。MEMORY_QUERY_EXPANSION / local-config queryExpansion を上書きします。
offsetintegerいいえget：前のスライスの続きを取得するため、本文をこの文字オフセットから開始します。
accountanyいいえsearch：特定のアカウントが書き込んだメモリに限定します。`mine` はこのサーフェス固有の MEMORY_ACCOUNT を意味します。配列を渡すと複数のアカウントを対象に読み取れます。アカウントラベルのないメモリは常に返されるため、ラベル機能が導入される前に書かれた内容も失われません。
forwardintegerいいえthread：アンカーの後に返すやり取りの数（デフォルトは 8）。`after` は search の DATE フィルターなので、after ではなく forward という名前です。
outlinebooleanいいえget：本文を含めず、見出しのアウトラインとサイズ、オフセットのみを返します。大きなメモリを読む前に、最小限のコストで内容を把握できます。
projectanyいいえsearch：プロジェクトフォルダー内のメモリに限定します。`this` はサーバーの標準プロジェクトを意味します。プロジェクトに属さないメモリは常に返されます。
queriesarrayいいえsearch のみ：同じ質問の別表現を最大 4 件指定できます。1 回の呼び出しで `query` と並べて順位付けされます。`results` は質問どおりの結果を保持します（各行には、その結果に一致した別表現を示す matchedVia が追加されます）。別表現だけで見つかった行は queryScore とともに viaVariants に含まれ、回答には含まれません。該当なしの判定は引き続き `query` に対して行われます。最初の検索結果で質問に答えられない場合（または拒否された場合）に限り、2 回目の試行で送信してください。毎回の検索で送信しないでください。測定では 1 回の呼び出しにつき約 50～370 ms、約 1.6K トークンを消費し、最初の検索で結果を見逃した場合にのみ役立ちます。expansion が 'off' の場合、および latest では無視されます。
replacebooleanいいえimport（category を指定）：同じ名前のファイルを再インポートすると、新しいバージョンが古いバージョンに取って代わります。古いファイルは metadata.supersededAt のタイムスタンプを付けて <category>/archive/ に移動され（インデックスから外れますが、削除はされません）、新しいファイルが置き換わります。改訂版のポリシーや法令に使用します。指定しない場合、既存の名前は従来どおりスキップされます。
sectionstringいいえget：この見出しのブロックのみを返します（次の同じレベルまたは上位レベルの見出しまで）。大きなメモリを読む際の主要な方法です。ページ分割より優先してください。
categorystringいいえimport：保存先の LIBRARY カテゴリを指定します（例：'books'、'manuals'、'policy'、'legal'。名前は任意で、新しい場合は memory-library/<category>/ ディレクトリが作成されます）。大きなファイル（テキストが 200KB 超）または書籍形式（PDF）のファイルでは必須です。指定しない場合、厳選コーパスをひそかに希薄化するのではなく、インポートを拒否します。カテゴリの内容は読み取り専用の参考資料として別個にインデックス化され、カテゴリ名を指定した場合または scope:'everything' の場合にのみ検索されます。取り込み時に構造を復元します。PDF の改ページは '## p.N' アンカーに、docx/html の見出しは実際の markdown 見出しに変換し、プレーンテキストの CHAPTER 行は見出しに昇格します。そのためセクション分割で文書が章ごとに分けられ、引用にはページアンカーが付きます。
keyFactsobjectいいえimport：任意指定，为インポートする文書の各 SECTION につき、セクション名をキーとして短い原子的な事実を 1～3 件指定します（'<doc>#<section-slug>'。単一文書のインポートではセクション slug のみでも可）。事実は各セクションのテキストから作成され、高重みの keys フィールドとしてインデックス化されるため、たまたま含まれる語句だけでなく、セクションの主題から検索できます。事実がコンテンツになることはなく、本文、スニペット、返却テキストは変更されません。サイドカーファイル <file>.keyfacts.json に保存されます。MEMORY_KEY_FACTS が有効な場合のみ読み取られます。
maxCharsintegerいいえget：本文の長さを制限します（デフォルトは 20000）。制限された応答には常に totalChars + truncated が含まれるため、一部の内容を文書全体と誤認しません。scope:'everything' を指定した search では、簡易ビューのスニペット予算を増やします（デフォルトは意図的に小さく設定されており、この指定で上書きします）。
sessionIdstringいいえsearch/latest/sessions：1 つの会話に限定します（取り込まれたやり取りに付与された transcript session id）。
sinceMinutesnumberいいえcapture：このセッションの直近 N 分間のみを記憶します。省略するとセッション全体が対象です。時間枠は質問された時刻ではなく、各やり取りの LAST ACTIVITY を基準にするため、進行中の長いやり取りも短い時間枠内に含まれます。作業中に memory connector が OFF で、後から重要だったと気づいた場合に使用してください。transcript はいずれにせよディスク上にあるため、失われたものはありません。取得したやり取りは STAGING コーパスの archive 層に保存され、手書きのメモリより優先されることはありません。取得済みのやり取りはスキップされるため、再実行しても安全です。現在のターンが進んでいた場合、再実行では exchangesCaptured ではなく exchangesRefreshed が報告されます。
includeSummariesbooleanいいえlatest：コンテキスト圧縮の要約を含むやり取りは、デフォルトで優先度が下がります。返却はされますが、通常のソースより後に並びます。会話全体を言い換えるため（ほぼすべてのクエリに一致する可能性がある一方）、古い内容に新しいタイムスタンプが付いているためです。false を渡すと完全に除外できます。

詳細

メンテナーはまだ詳細を追加していません。リポジトリの README をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。