mcpField
A
agentmemory-mcp-tools

agentmemory-mcp-tools

github.com/rohitg00エージェントワークフロー30.0k11.0k 回インストール今日更新
リポジトリ

agentmemory-mcp-tools について

agentmemory-mcp-toolsは、agentmemoryが提供するMCPツールを説明するスキルです。文書化されたスキーマに基づき、メモリの記録・検索、セッション、グラフ、スロット、ガバナンス操作を選べます。

主な機能

  1. 01MCPツール群とスキーマの一覧
  2. 02メモリの保存と検索
  3. 03セッション、ファイル、タイムラインの取得
  4. 04ナレッジグラフと構造化スロットの照会
  5. 05ガバナンスとヘルスチェックの実行

活用シーン

  1. 01後で検索するための知見の保存
  2. 02絞り込んだクエリによるメモリ検索
  3. 03セッションやメモリ間の関係の確認

MCP 対応

このスキルはagentmemory MCPサーバーが提供するツールを説明します。メモリの記録・検索、セッション、ナレッジグラフ、構造化スロット、ガバナンス、ヘルスチェックの操作を扱います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-mcp-tools

インストール後、Claude Code で/agentmemory-mcp-toolsを入力して読み込まれたか確認します。

同梱ファイルREFERENCE.mdTROUBLESHOOTING.md

詳細

このスキルは、agentmemory の MCP ツールをインデックス化します。接続先サーバーのツール一覧とスキーマを使用してください。ネイティブのメモリプロバイダーでは、異なる名前でより少ないツールしか公開されない場合があります。すべての機能を必要とする Hermes および OpenClaw のスキルでは、稼働中のデーモンへの別個の MCP 接続が必要です。Pi と OMP では、--with-mcp を指定して接続すると、より幅広いワークフローを利用できます。Pi では MCP 名に mcp__agentmemory__ というプレフィックスが付きます。OMP では、write ツールを通じて MCP 操作が xd://mcp__agentmemory_<tool> デバイスとして公開されます。

クイックスタート

保存してから呼び出します。

  1. memory_save に content(知見)、concepts(カンマ区切りのキーワード)、files(カンマ区切りのパス)を指定します。
  2. 後で保存した知識を取得するには、memory_smart_search に query、limit、targetLayer: "memory" を指定します。記録された観察も検索するには、targetLayer を省略します。これは、BM25 とベクトル検索、グラフ展開検索を組み合わせたハイブリッド検索を実行します。

ツールファミリー

  • 取り込み:memory_save、memory_compress_file。自動観察には、ネイティブフックまたは POST /agentmemory/observe を使用します。MCP の観察ツールはありません。
  • 取得:memory_smart_search、memory_recall、memory_file_history、memory_timeline、memory_vision_search。
  • セッションとコミット:memory_sessions、memory_commits、memory_commit_lookup。
  • ナレッジとグラフ:memory_lesson_save、memory_lesson_recall、memory_graph_query、memory_relations、memory_patterns、memory_crystallize。
  • 構造化スロット:memory_slot_create、memory_slot_append、memory_slot_get、memory_slot_list、memory_slot_replace、memory_slot_delete。
  • ガバナンスと健全性:memory_governance_delete、memory_audit、memory_verify、memory_heal、memory_diagnose。

ワークフロー

  1. タスクに最も適した、範囲の狭いツールを選びます。幅広い検索には memory_smart_search、対象を絞ったクエリがすでにある場合には memory_recall、セッションの一覧表示には memory_sessions を優先します。
  2. 呼び出す前に REFERENCE.md で正確なパラメーター名と必須項目を確認します。
  3. ドキュメントに記載されたフィールドのみを渡します。REST ハンドラーはフィールドをホワイトリストで管理しており、未知のフィールドは破棄されます。
  4. 予算を指定する memory_recall では、matched_count: 0 と excluded_by_budget > 0 を区別します。切り詰められた ID や省略された ID は、同じスコープフィルターを維持しながら、memory_smart_search と expandIds を使って展開します。

関連項目

  • HTTP 相当の機能については agentmemory-rest-api を参照してください。
  • ツールの表示設定と機能フラグについては agentmemory-config を参照してください。
  • ユーザーが呼び出せるアクションスキル(remember、recall、recap、handoff、forget)は、よく使われるツールをラップしています。

リファレンス

パラメーターとコアセットのマークを含むツール一覧は REFERENCE.md にあります。ソースから生成されるため、内容がずれることはありません。

コメント