mcpField
A
agentmemory-rest-api

agentmemory-rest-api

github.com/rohitg00Agent 工作流30.0k11.0k 次安装1 天前更新
代码仓库

关于 agentmemory-rest-api

这项 skill 介绍 agentmemory 的 REST API，这是执行记忆操作的主要接口，面向 Agent 和开发者。内容涵盖本地端点、身份验证及凭据安全处理。

主要功能

  1. 01通过 HTTP 执行记忆操作
  2. 02Bearer 身份验证说明
  3. 03可配置 REST 端口
  4. 04文档化响应约定

适用场景

  1. 01通过 HTTP 保存或读取记忆
  2. 02检查守护进程是否存活
  3. 03配置远程守护进程的访问

MCP 相关

MCP 被描述为构建在 REST API 之上的桥接层；agentmemory-mcp-tools 提供对应的 MCP 功能。

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/agentmemory-rest-api确认已加载。

附带文件REFERENCE.mdTROUBLESHOOTING.md

详细介绍

REST 是 agentmemory 的主要接口。MCP 是在其上构建的桥接层。每项记忆操作都有一个 HTTP 端点，位于 http://localhost:3111/agentmemory/* 下。

快速开始

# 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}'

身份验证

默认情况下，受保护的端点需要进行 bearer 身份验证，包括 localhost。存活状态检查为公开端点。示例使用显式设置的环境密钥或生成的本地密钥文件；如果守护进程使用其 .env 中的密钥，请在本地加载该值，但不要显示它。对于远程守护进程，必须为该端点提供显式凭据并使用 HTTPS。切勿转发本地文件中的密钥，也不要跟随经过身份验证后重定向到其他主机的请求。请参阅 TROUBLESHOOTING.md。

约定

  • 保存操作返回 201，读取操作返回 200，验证错误返回 400。
  • 仅使用文档中列出的字段。成功响应并不能证明不受支持的字段已生效。
  • REST 端口默认为 3111，可通过 --port 或 --instance 配置。查看器默认为 3113；内部引擎 WebSocket 默认使用 49134。

另请参阅

  • agentmemory-mcp-tools：MCP 等效工具。
  • agentmemory-config：本地配置和密钥。

参考

完整端点列表及其方法位于 REFERENCE.md 中，由 src/triggers/api.ts 生成。

评论

支持 Markdown