mcpField
A
agentram-mcp

agentram-mcp

本地服务
github.com/seanmarkwei记忆与知识011 周前更新
代码仓库

关于 agentram-mcp

agentram-mcp 是为 AI Agent 提供持久记忆的 MCP 服务，使用 AgentRAM。它区分普通记忆与时序事实记录，并支持共享空间和变更历史，无需向量数据库或嵌入流程。

主要功能

  1. 01按键存储和读取记忆
  2. 02无需嵌入的文本搜索
  3. 03通过命名空间共享记忆
  4. 04记录事实变化及其历史
  5. 05检测当前事实冲突

适用场景

  1. 01保留跨会话上下文
  2. 02在多个 Agent 间共享记忆
  3. 03查看事实随时间的变化

MCP 相关

它将 AgentRAM 的记忆操作封装为 MCP 工具，供 MCP 客户端调用，包括存储、搜索、共享空间和时序断言。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "seanmarkwei-agentram": {
      "command": "npx",
      "args": [
        "-y",
        "agentram-mcp"
      ],
      "env": {
        "AGENTRAM_API_KEY": "<AGENTRAM_API_KEY>"
      }
    }
  }
}
启动命令npx -y agentram-mcp
需要配置的环境变量
AGENTRAM_API_KEY密钥Your AgentRAM API key, starts with agentram_. Get one free at https://agentram.dev

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmagentram-mcp0.1.1

工具

10

收录的工具列表 · 更新于 2 周前

参数类型必填说明
keystring是记忆标签。最多 200 个字符。
valuestring是要记住的内容。最多 5,000 个字符。
agent_idstring是Agent 的唯一标识符。最多 100 个字符。
ttl_daysnumber否可选。此记忆自动过期前的天数。不填写则永久保存。

详细介绍

agentram-mcp

适用于 AgentRAM 的 MCP 服务。它通过一组工具为 AI Agent 提供持久记忆，无需设置向量数据库或嵌入处理流程。获取密钥，粘贴下面的配置，大约一分钟即可运行。

适用于任何 MCP 客户端：Claude Desktop、Claude Code、Cline、Cursor、Windsurf 等。

为什么选择它

每次 Agent 会话开始时都像失忆了一样。AgentRAM 是专为 Agent 打造的纯 HTTP 记忆存储：调用一次保存内容，再调用一次读取内容。无需搭建基础设施，也不用操心向量。此软件包将该 API 封装为 MCP 工具，让你的 Agent 直接使用。

设置

你需要先获取 API 密钥。在 agentram.dev 注册后，密钥会通过电子邮件发送给你。新账户会获得 1,000 个积分，无需绑定银行卡。

然后将以下内容添加到客户端的 MCP 配置中。对于 Claude Desktop，该文件为 claude_desktop_config.json（在 macOS 上，文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "agentram": {
      "command": "npx",
      "args": ["-y", "agentram-mcp"],
      "env": {
        "AGENTRAM_API_KEY": "agentram_your_key_here"
      }
    }
  }
}

重启客户端后，工具就会显示出来。大多数客户端都允许将工具设为“始终允许”，这样每次调用时就不必点击批准。

macOS 用户要注意：Claude Desktop 未附带 Node，因此请先安装 Node 18 或更高版本，否则服务将无法启动。

工具

共 15 个工具。10 个用于平面记忆，5 个用于时间记忆（会随时间变化的事实）。

平面记忆：

  • store_memory：为某个 Agent 在指定键下保存一个值
  • retrieve_memory：按键读取已保存的值
  • list_memories：列出为某个 Agent 存储的所有内容
  • search_memories：搜索键和值中的文本，无需嵌入
  • delete_memory：删除一条记忆
  • check_credits：查看当前余额，可免费调用

共享记忆，适用于多个 Agent 需要使用同一记忆池的情况：

  • create_namespace：创建共享空间，可免费调用
  • store_shared_memory：向其中写入内容
  • retrieve_shared_memory：从中读取内容
  • list_shared_memories：列出其中的内容

时间记忆（断言）：

  • store_assertion：记录可能变化的事实，例如计划、状态或偏好
  • retire_assertion：将事实标记为不再成立，同时保留历史记录
  • get_assertion：获取某个键当前成立的内容
  • list_assertions：列出某个 Agent 当前的所有事实
  • get_assertion_history：查看某个键随时间变化的完整记录

关于时间记忆

平面记忆会覆盖旧值。时间记忆会保留变化轨迹。事实发生变化时，你可以用新值取代旧值；之前的值也会保留下来，因此你能了解当前状态是如何形成的。

值得了解的一点：如果两个不同的值落在同一个键下，且彼此都没有取代对方，get_assertion 不会悄悄选出一个值。它会告知该键存在冲突，并返回两个值，让你的 Agent 自行判断，而不是凭猜测行事。list_assertions 会标记出哪些键处于这种状态。

平面记忆和时间记忆使用不同的键空间。store_memory 中名为 plan 的键与 store_assertion 中名为 plan 的键毫无关联。对于只需覆盖的内容，请使用平面记忆；对于希望保留记录的事实，请使用断言。

积分

每次读写消耗 1 个积分。check_credits 和 create_namespace 免费。读取时若未找到内容（返回 404），会退还积分。大多数响应都会包含 credits_remaining，方便你查看余额。

配置

  • AGENTRAM_API_KEY（必需）：你的密钥，以 agentram_ 开头
  • AGENTRAM_API_BASE（可选）：默认为 https://api.agentram.dev

链接

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。