
Agent Memory
io.github.theprodsde由 GitHub 账号 theprodsde 发布v0.1.5更新于 Oct 24, 2026
Persistent agent memory with a decision layer: replay, restore, verify, or none — explainable.
发布方自己的服务:Memory.fit
概览
为 AI 代理提供本地持久记忆,对每次查询返回明确的 replay、restore、verify 或 none 决策。
- 可以做什么
- 用已存记忆解析查询,返回明确动作(replay、restore、verify 或 none)及置信度和理由,并为 restore 决策生成格式化上下文。存储带标签、类型、作用域、置信度和 TTL 的查询/回答对。分页列出记忆,支持作用域和归档筛选,并按 ID 获取单条记录。归档记忆使其不参与检索、永久删除记忆,以及将近重复记忆合并为摘要条目。
- 适用场景
- 适合代理在多次会话中回答相同或相似问题,且需要控制已存答案是原样重放、作为上下文注入、先验证还是跳过。也适合可能过时的事实型答案、多个代理共享知识库,以及需要审计哪条记忆作答及原因的场景。不适合对文件语料做文档 RAG,也不应替代应用的权威数据库。
- 运行要求
- 作为本地 stdio 进程运行,通过 uvx 从 PyPI 包 agent-memory-sdk 启动,需要 Python 和 uv。默认使用本地 SQLite 存储,目录由 AGENT_MEMORY_DIR 指定(默认 ~/.agent_memory),集合由 AGENT_MEMORY_COLLECTION 指定。无需 API 密钥;可选的 Redis 或 PostgreSQL 后端需要相应服务。
安装
在 SourceWeft 中
- 打开 控制台中的 Agent Memory,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
Agent Memory
[CI] [Python 3.10+] [License: Apache-2.0] [PyPI version] [MCP Registry]
Persistent semantic memory for AI agents with intelligent decision-making.
🚀 Created by: TheProdSDE
The problem
Most AI memory systems retrieve and inject past context into every prompt. This leads to wasted tokens, inconsistent responses, and agents that blindly replay stale or wrong answers.
Agent Memory adds a decision layer:
Every resolve() returns an explicit action with a scored, explainable rationale —
not just a retrieved chunk.
Adversarial eval: 34/36 (94%) on trap queries — the 2 misses return VERIFY (cautious), never a wrong REPLAY — see benchmarks.
Context rot — what this solves (and what it can't)
Context rot is the measured degradation of LLM accuracy as the context window fills — long before the token limit. Stale chunks, irrelevant retrievals, and unbounded conversation history don't just waste tokens; they actively degrade answers ("lost in the middle", instruction drift, distractor sensitivity).
Context rot has two causes. Agent Memory addresses the first; nothing outside the model itself can address the second.
1. What goes into the context — controllable, and this SDK's job:
2. How the model attends over tokens already in its context — not controllable from outside. Attention degradation over long context is a property of the model. No memory layer changes that. What Agent Memory does is keep the context small and relevant enough that the model rarely enters the degraded regime in the first place.
The honest claim: Agent Memory prevents context pollution — the dominant
controllable cause of context rot in agentic systems. It doesn't change model attention
behavior, and it only helps if your agent routes context through resolve() /
PagedMemory instead of concatenating history by hand.
How it compares
Today you need three tools wired together to get what resolve() does in one call:
a semantic cache (GPTCache) for replay, a memory layer (Mem0 / Zep) for context, and
custom staleness logic for verification. No existing tool decides — at read time —
whether and how a memory should be used.
Cells about other projects are capability checks against their own source or
docs (mem0 checked on 2026-09-27), not measured behaviour; ❔ means we have not
tested it rather than that it is absent. Corrections welcome — see
docs/comparison.md for sourcing and the
benchmark RFC for the review process.
Because hosted or model-backed configurations can add an LLM or embedding API round-trip per memory operation, their latency includes provider, model, and network costs. Exact latency depends on each project's configuration; this repository does not publish a universal 100ms–2s floor. Agent Memory resolves in-process in SQLite-only mode; measured latency depends on corpus shape and cache state (see performance and stress-testing details).
On retrieval, we publish a cleaned-release retrieval-proxy measurement below. On end-to-end accuracy (LLM answering + judge, where Mem0 and Zep publish), we don't quote numbers we haven't measured yet — that stage is next on the roadmap. → Full feature matrix and trade-offs (including where they're better): docs/comparison.md
Benchmarked on LongMemEval (ICLR 2025)
LongMemEval is a benchmark for conversational-history retrieval. These results measure Agent Memory's RESTORE/retrieval tier, not REPLAY, VERIFY, TTL, or end-to-end answer correctness. Each question runs against a separate SQLite store containing that question's haystack; aggregate ingestion totals are not the size of one queried store. All ingestion uses zero LLM calls and $0 in API charges:
-
LongMemEval_S (500 independent ~48-session haystacks; 124K turn-pair entries across all runs): 98.1% session Recall@5 with local ONNX embeddings, 96.0% lexical-only, 10.04ms lexical / 19.56ms semantic p50 retrieval. The report includes p90/p95/p99 and run-resource measurements.
-
LongMemEval_M (500 independent ~500-session haystacks; ~2,500 turn-pair entries per queried store): 87.0% session Recall@5 with lexical retrieval, 12.05ms p50. This uses the official cleaned re-release and turn-pair indexing; it is not directly comparable with the paper's original-release session-index baselines.
[LongMemEval_S retrieval by question type]
[LongMemEval_M result and published baseline context]
Full methodology, per-type tables, scope notes (what this benchmark does and
doesn't test), and negative results are in the
benchmark report. Reproduce the semantic
_S result with uv run python benchmarks/longmemeval/run_retrieval.py --semantic.
Real software, not a prototype
Every claim below is reproducible from this repo:
- 34/36 (94%) on adversarial decision-quality eval, and the 2 misses fail safe (VERIFY, never wrong REPLAY) —
agent-memory eval(methodology) - LongMemEval retrieval proxy: 98.1% Recall@5 (_S, semantic) · 87.0% (_M, lexical) — 500 independent haystacks; not an end-to-end or paper-baseline head-to-head, full report
- Reproducible stress harness for synthetically seeded workloads up to 1,000,000 entries; archive the JSON output before publishing a performance claim (methodology)
- Stress-test benchmark charts: latency percentiles, seed throughput, resource use, action mix, and cache/decision rates for lexical FTS5 runs at 10K, 100K, and 1M entries, with workload and archived result JSON documented in stress-testing
- 412 collected tests across 25 test modules — decision quality, concurrency, all 4 backends, MCP server, adapters — run in CI on every push
- Published on PyPI and the official MCP Registry
- Ships with a REST API, Streamlit dashboard, CLI, LangChain/LlamaIndex adapters, and async counterparts for memory read/write and decision operations
When to use it — real use cases
Where Agent Memory saves real money
A GPT-4o call costs ~$0.005. A support agent handling 50,000 queries/day with 70% repeat rate:
- Without memory: 50,000 × $0.005 = $250/day
- With Agent Memory: 15,000 LLM calls + cache misses = $75/day
- Saving: ~ $175/day (~$64k/year)
- Savings depend on your repeat rate and how similar incoming queries are to previously stored ones — measure in your own pipeline.
REPLAY avoids an LLM call when policy permits it. The latency and cost difference depends on the local workload, provider, model, and network; measure both paths in your own pipeline.
Is it right for your use case?
Good fit:
- Agent answers the same or similar questions across sessions
- You have fact-sensitive answers that can go stale (prices, limits, policies)
- Multiple agents or services share a knowledge base
- You need audit trails — knowing which memory answered and why
Not the right tool:
- Document RAG over a corpus of files → use a vector database for that
- Replacing your application's source-of-truth database
- Agents that never repeat similar queries
Features at a glance
→ Full feature reference: docs/features.md
Performance
Latency, CPU, and memory use depend on the corpus, query distribution, cache state, embedding mode, machine, and operating system. The bundled harness uses a repeatable synthetic workload; it does not establish a production SLA.
The current lexical FTS5 benchmark results and charts are archived with their source JSON in the stress-test methodology. See that document for commands, workload scope, and guidance on interpreting results.
When to use it
Use Agent Memory when:
- You want an agent to remember past interactions without injecting all of them into every prompt
- You need explicit control over when memory is used (replay exact answers vs inject as context vs verify first)
- You have different memory trust levels (user preferences vs potentially-stale facts vs tool outputs)
- Multiple processes, services, or agents share the same memory store
- You need audit trails — every replay is traceable to a specific stored entry with a score breakdown
Don't use it for:
- Document RAG (search over a corpus of files) — use a vector database for that; Agent Memory stores query→answer experiences
- A replacement for your database — it stores transient agent knowledge, not your application's source-of-truth data
Quick Start
→ Full integration pattern and API reference: docs/usage.md
Local Setup
Option 1 — SQLite (zero dependencies, recommended to start)
Option 2 — Redis or Postgres backend
Option 3 — Streamlit dashboard (visual exploration)
Option 4 — Development / from source
Dashboard
An interactive Streamlit dashboard for exploring memories, testing the resolve sandbox, and monitoring stats.
[Agent Memory dashboard slideshow: stats, memory table, replay/verify/none resolve results]
MCP Server
Agent Memory is published on the MCP Registry — install it in any MCP-compatible client with zero manual setup.
Add to your MCP client
Cursor — add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json globally:
Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Claude Code — add to .claude/settings.json in your project:
uvx installs the package on first run — no pip install needed.
Custom storage location
Tools exposed
→ Full MCP setup guide and Docker config: docs/mcp.md
Integrations
agent-memory-sdk is the core — every integration delegates to Memory.
→ Setup instructions and code snippets for each: examples/README.md
Tech Stack
No API keys required — everything runs locally.
Documentation
Status & Roadmap
All planned features through v0.5.0 are shipped. Track what's next on the GitHub Project →
Release
Tag-triggered, fully CI-gated: git tag v0.x.y && git push origin v0.x.y
Contributing
See CONTRIBUTING.md for dev setup, test commands, and the PR checklist.
Citation
If you use Agent Memory SDK or its benchmark suite in your research, articles, or projects, please cite this repository using GitHub's Cite this repository button.
For reproducible benchmark comparisons, reference the exact SDK version, benchmark dataset version, configuration, and Git commit.
License
Apache-2.0 — see LICENSE.
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: [email protected]
Agent Memory helps agents decide: Replay → Restore → Verify → Ignore
Built with ❤️ by TheProdSDE
mcp-name: io.github.theprodsde/agent-memory
来源:README.md,提交 62bab6e
工具
0版本历史
1- v0.1.5最新Sep 23, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。
其他 Memory 集成

Memory.fit
fit.memory官方发布者
托管式 Memory.fit 服务器,让 AI 读取你的训练、睡眠、恢复与饮食数据,并写回每周计划、每日目标和饮食计划。
pg.ddx.io: the PostgreSQL community's memory
io.ddx.pg官方发布者
pg.ddx.io: the PostgreSQL community's memory 的托管 MCP 服务,由 pg.ddx.io 发布;无需登录;Streamable HTTP;29 个工具。
var.gg Naming Memory
gg.var官方发布者
远程 MCP 服务器,可根据领域概念推荐并检索韩、日、中、越、英多语言的代码标识符名称,并提供 ERD 结构查询。

Counterparts
ai.counterparts
面向 Claude Code 与 Claude Desktop 的本地优先长期记忆:助手自行写下关于你和项目的笔记,并在之后的会话中回忆起来。

LAHZE - Persian AI Memory Platform
由 GitHub 账号 pedramgholizadeh 发布
以波斯语为先的地理记忆平台:发现地点,起草并发布仅限波斯语的记忆。AI 翻译