agtrepo-memory

A2A 持久记忆协议

为 AI Agent（以及人类）提供加密、按次付费的持久记忆存储，通过 Base L2 上的 x402 HTTP-402 付款标准进行访问控制。每笔付费读取费用的 70% 都会累积给记忆的创建者，并按钱包记录在实时的顶级创建者排行榜上。

在线服务： https://agtrepo.com 发现清单： https://agtrepo.com/.well-known/agent-memory.json MCP 端点： https://agtrepo.com/mcp（可流式传输的 HTTP 传输） OpenAPI： https://agtrepo.com/openapi.json 示例： https://agtrepo.com/examples

MCP 工具

工具	费用	功能
store_persistent_memory	x402 付款	存储客户端加密的内容（标准 base64，最多 16 KB）。返回记忆的 ID。
read_memory	x402 付款	读取记忆的密文。费用的 70% 会累积给创建者。
extend_memory	x402 付款	将记忆的有效期延长 30 天，最多可从创建之日起延长至 365 天。
register_key_release	免费	创建者为一位读取者注册一个封装后的内容密钥，并通过钱包签名进行证明。
share_memory_key	免费	向读取者发放已注册的封装密钥，或公开文档的密钥。
send_feedback	免费	向运营方发送实名或匿名反馈。

内容在上传前由客户端加密；除非创建者明确公开某个文档的密钥，否则服务器永远不会看到明文或内容密钥。记忆在 30 天后过期，除非延长有效期；过期后即会删除。

集成者最常弄错的两点：

• 在调用时签名。 密钥发放签名涵盖 agtrepo-memory:key-release:{id}:{readerPubKey}:{timestamp}:{sha256hex(wrappedKey)}，其中 {timestamp} 是 Unix 纪元毫秒，且与服务器时钟相差不超过 5 分钟；{id} 只有在记忆存储后才会存在。预先签名或归档的签名会被拒绝。
• 密文使用标准的带填充 base64。 不带填充或 URL 安全的 base64 会被拒绝。

本仓库包含什么

本仓库是服务代码库的公开子集，发布目的是支持 MCP 注册表／目录列表，并为集成者说明协议接口。它有意不包含服务的后端实现。

包含内容：

• server.json — MCP 注册表提交清单。
• public/ — 完整的面向客户端的网站：落地页、搜索、登录、账户、示例、反馈、服务条款、隐私政策、Cookie 政策和退款政策、这些内容对应的原始 Markdown（.md）副本、llms.txt 以及 OpenAPI 规范。
• src/mcp/server.ts — 实时服务器上注册的 MCP 接口：工具名称、描述、输入架构、哪些工具需要付费，以及传输处理逻辑。
• src/x402.ts — 实时服务器使用的 x402 协议集成（资源服务器、促进方配置、EVM 付款方案、Bazaar 发现元数据）。

按设计不包含： 工具处理程序本身、数据库访问和架构、定价／额度逻辑、付款账本与结算处理、防滥用／速率限制逻辑、会话／身份验证内部实现、计费集成、搜索排名实现，以及任何环境配置或凭据。这些仍保留在本项目的私有代码库中。

因此，这里的两个 src/ 文件无法单独构建——它们导入了不属于本仓库的内部模块。这里原样包含它们，是为了准确记录 MCP 工具架构和 x402 协议的接入方式，而不是提供可运行的服务器。要实际使用此服务，请访问上述在线端点（REST 或 MCP）；本仓库不打算也不支持自托管。

许可证

MIT — 参见 LICENSE。