用途
AgentRAM MCP 是一个为 AI 代理提供持久化记忆的 Model Context Protocol 服务器。每个代理会话开始时都像患有失忆症一样——AgentRAM 是一个专为代理构建的普通 HTTP 记忆存储：一次调用保存内容，一次调用读回内容。无需搭建基础设施，无需管理向量。本包将该 API 封装为 MCP 工具，代理可以直接使用。
主要能力
该服务器提供十五个工具，分为平面记忆和时间性记忆两类。
平面记忆（十个工具）：
- store_memory：为某个代理在某个键下保存一个值
- retrieve_memory：按键读取一个值
- list_memories：列出为某个代理存储的所有内容
- search_memories：在键和值中进行文本搜索，无需嵌入
- delete_memory：删除一个条目
- check_credits：查看当前余额，免费调用
共享记忆（当多个代理需要同一个池时）：
- create_namespace：创建一个共享空间，免费调用
- store_shared_memory：向其中写入
- retrieve_shared_memory：从其中读取
- list_shared_memories：列出其中的内容
时间性记忆（断言，五个工具）：
- store_assertion：记录一个可能变化的事实，如计划、状态或偏好
- retire_assertion：将一个事实标记为不再为真，同时保留历史
- get_assertion：获取某个键当前为真的事实
- list_assertions：列出某个代理当前的所有事实
- get_assertion_history：获取某个键在历史上曾经是什么的完整链条
关于时间性记忆
平面记忆会覆盖旧值。时间性记忆会保留轨迹。当一个事实变化时，你用新值取代旧值，而之前的值会保留下来，以便查看当前值是如何演变而来的。
值得特别了解的一点：如果两个不同的值落在同一个键上，且谁都没有取代谁，get_assertion 不会悄悄选择一个胜出者。它会告诉你该键存在争议，并返回两个值，让你的代理自行决定，而不是基于猜测运行。list_assertions 会标记出处于这种状态的键。
平面记忆和时间性记忆是不同的键空间。store_memory 中名为 plan 的键，与 store_assertion 中名为 plan 的键彼此毫无关系。对于只需要覆盖的内容使用平面记忆，对于希望保留记录的事实使用断言。
使用方式
首先需要 API 密钥。在 agentram.dev 注册，密钥会通过电子邮件发送给你。新账户起始有 1,000 积分，无需信用卡。
然后将配置添加到客户端的 MCP 配置中。对于 Claude Desktop，该文件是 claude_desktop_config.json（在 macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json）。重启客户端后工具就会出现。大多数客户端允许你将它们标记为“始终允许”，这样就不必每次调用都点击批准。
macOS 上的一个注意点：Claude Desktop 不自带 Node，因此请先安装 Node 18 或更新版本，否则服务器无法启动。
环境变量：
- AGENTRAM_API_KEY（必需）：你的密钥，以 agentram_ 开头
- AGENTRAM_API_BASE（可选）：默认为 https://api.agentram.dev
适用场景
适用于任何支持 MCP 的客户端：Claude Desktop、Claude Code、Cline、Cursor、Windsurf 等。适合需要让 AI 代理跨会话记住信息、共享记忆，或追踪会随时间变化的事实（如状态、偏好、计划）的场景。
限制
读写操作各消耗 1 积分。check_credits 和 create_namespace 免费。一次未找到内容的读取（404）会退还积分。大多数响应会包含 credits_remaining，方便你监控余额。
更多信息：
- 网站：https://agentram.dev
- 文档：https://agentram.dev/docs.html
- 问题反馈：https://github.com/seanmarkwei/agentram-mcp/issues
