mcpField
A
agentmemory-rest-api

agentmemory-rest-api

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

agentmemory-rest-api について

agentmemory の主要なメモリ操作インターフェースである REST API の利用方法を説明するスキルです。ローカルエンドポイント、認証、認証情報の安全な扱いを Agent や開発者向けに解説します。

主な機能

  1. 01HTTP によるメモリ操作
  2. 02Bearer 認証の説明
  3. 03REST ポートの変更
  4. 04レスポンス規約の説明

活用シーン

  1. 01HTTP 経由でのメモリ保存・取得
  2. 02デーモンの稼働確認
  3. 03リモートデーモンへのアクセス設定

MCP 対応

MCP は REST API 上のブリッジとして説明されています。対応する MCP 機能は agentmemory-mcp-tools にあります。

インストール

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

$npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-rest-api

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

同梱ファイルREFERENCE.mdTROUBLESHOOTING.md

詳細

REST は agentmemory の主要インターフェースです。MCP はその上に構築されたブリッジです。すべてのメモリ操作には、http://localhost:3111/agentmemory/* 以下に HTTP エンドポイントがあります。

クイックスタート

# liveness
curl -fsS http://localhost:3111/agentmemory/livez

# For this fixed loopback URL only. Do not print the value or enable shell tracing.
agentmemory_secret="${AGENTMEMORY_SECRET:-$(cat "$HOME/.agentmemory/secret")}"
test -n "$agentmemory_secret" || exit 1

# save
curl -fsS -X POST http://localhost:3111/agentmemory/remember \
  -H "Authorization: Bearer $agentmemory_secret" \
  -H "Content-Type: application/json" \
  -d '{"content":"chose JWT refresh rotation","concepts":["jwt-refresh-rotation"]}'

# recall
curl -fsS -X POST http://localhost:3111/agentmemory/smart-search \
  -H "Authorization: Bearer $agentmemory_secret" \
  -H "Content-Type: application/json" \
  -d '{"query":"auth token strategy","limit":5}'

認証

保護されたエンドポイントでは、localhost を含め、デフォルトでベアラー認証が必要です。稼働状態の確認エンドポイントは公開されています。この例では、明示的に指定した環境変数のシークレット、または生成されたローカルのシークレットファイルを使用します。デーモンが .env のシークレットを使用している場合は、その値を表示せずにローカルで読み込んでください。リモートデーモンでは、そのエンドポイント用の明示的な認証情報と HTTPS を必須としてください。ローカルファイルのシークレットを転送したり、認証済みのリダイレクトに従って別のホストへ移動したりしないでください。TROUBLESHOOTING.md を参照してください。

規約

  • 保存は 201、読み取りは 200、検証エラーは 400 を返します。
  • ドキュメントに記載されたフィールドのみを使用してください。レスポンスが成功しても、未対応のフィールドが適用されたことの証明にはなりません。
  • REST ポートのデフォルトは 3111 で、--port または --instance で設定できます。ビューアーのデフォルトは 3113、内部エンジンの WebSocket のデフォルトは 49134 です。

関連項目

  • MCP 版については agentmemory-mcp-tools を参照してください。
  • ローカル設定とシークレットについては agentmemory-config を参照してください。

リファレンス

メソッドを含むエンドポイント一覧は REFERENCE.md にあります。src/triggers/api.ts から生成されています。

コメント

Markdown 対応