Agentos Memory

MCP数据服务

提供方 joemc1470

数据服务 未标注 会话登录 社区 / 第三方 Claude

AgentOS Memory是一个为Claude Code提供持久化、可搜索记忆的MCP服务器,支持跨会话、跨项目的永久存储。

一句话选型结论

按资料字段整理

Agentos Memory 属于数据服务类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 11 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量11暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

持久化存储TypeScript本地部署全文搜索会话日志知识图谱SQLite本地运行

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 11 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 11 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Agentos Memory当前 11 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方joemc1470上游标注的维护方 joemc1470
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.0 KB
来自项目仓库与上游目录的原文,未做删改

AgentOS内存——给Claude代码一个永久内存

Claude Code在会话之间会忘记一切。这解决了这个问题。

AgentOS Memory是一个MCP(模型上下文协议)服务器,它为Claude Code提供持久、可搜索的内存——在每个会话、每个项目中,永远如此。它在本地运行,将所有内容存储在SQLite中,不需要任何外部服务。```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash


______________________________________________________________________

## 为什么?

每次启动Claude Code会话时,您都是从零开始的。你重新解释你的堆栈。重新描述你的偏好。重新讲述你三周前做出的决定。今天是土拨鼠日,但对于你的人工智能助手来说。

AgentOS内存为Claude Code提供了一个实际的内存。存储事实。稍后搜索它们。导入您的ChatGPT历史记录。它在会话、项目甚至机器之间持续存在(如果同步SQLite文件)。

______________________________________________________________________

## 特性

- 🧠 **持久内存** --在所有Claude Code会话中存储事实、决策和上下文
- 🔍 **全文搜索** -SQLite FTS5在没有矢量数据库或API的情况下为您提供快速、相关的结果
- 📔 **会话日志** --日志对话转向;再也不会因为压缩而失去上下文
- 🕸️ **知识图谱** --店铺结构化主题→谓语→客观事实
- 📥 **导入您的历史记录** --从ChatGPT导出、Claude文件或任何标记中引入内存
- ⚡ **零依赖** --仅限SQLite。没有Postgres,没有Redis,没有API密钥,没有云
- 🔌 **独立工作或与AgentOS配合使用** --单独使用,或作为完整AgentOS网格的一部分使用
- 🏃 **即时安装** --一个 `curl | bash`,适用于macOS和Linux

______________________________________________________________________

## 安装```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash

安装程序:

  1. 检查 bun (如果缺少,则安装)
  2. 将服务器下载到 ~/.agentos-memory/
  3. 跑 bun install
  4. 在Claude Code注册为用户级MCP服务器

安装后,启动任何Claude Code会话,工具就会自动可用。

手动安装 (如果你愿意的话):```bash
git clone https://github.com/joemc1470/agentos-memory.git ~/.agentos-memory
cd ~/.agentos-memory && bun install
claude mcp add -e AGENTOS_MODE=standalone -s user agentos-memory -- bun ~/.agentos-memory/src/index.ts


______________________________________________________________________

## 快速开始

安装后,打开Claude Code并尝试:```
Use memory_add to remember: I prefer TypeScript over Python, always use strict mode

结束会话。打开一个新的:```
Use memory_search to find my language preferences


每次克劳德都会找到的。

______________________________________________________________________

## 建筑```
Claude Code Session
│
│ MCP (stdio)
▼
┌──────────────────────────────────┐
│      AgentOS Memory Server       │
│  ┌────────────┐ ┌─────────────┐  │
│  │  11 Tools  │ │   Config    │  │
│  └────────────┘ └─────────────┘  │
│          │                       │
│          ▼                       │
│  ┌────────────────────────────┐  │
│  │   Standalone Mode          │  │
│  │   SQLite + FTS5            │  │
│  │  ~/.agentos-memory/data/   │  │
│  │  ├── memories.db           │  │
│  │  │   ├── memories (FTS5)   │  │
│  │  │   ├── journal  (FTS5)   │  │
│  │  │   └── facts    (FTS5)   │  │
│  └────────────────────────────┘  │
│          OR                      │
│  ┌────────────────────────────┐  │
│  │   Full AgentOS Mode        │  │
│  │   Mem0 + Qdrant + KG       │  │
│  │   3-tier memory search     │  │
│  │   Context Engine           │  │
│  └────────────────────────────┘  │
└──────────────────────────────────┘

工具参考

🧠 记忆

工具 说明
memory_search 在存储的记忆中进行全文搜索。返回评分结果。
memory_add 持久地存储一个事实、偏好或决定。

用途:```
memory_add: "The production database is PostgreSQL 15 on AWS RDS, us-east-1"
memory_search: "production database"
→ returns the fact above in future sessions


### 📔 期刊

|工具|说明|
|------|-------------|
| `journal_entry` |记录与参与者、主题和情绪的对话。 |
| `journal_search` |按主题或关键字搜索过去的日记条目。 |

日记是你谈话的保险。当LCM压缩你的上下文时,期刊就拥有了一切。

### 🏛️ 记忆宫殿

|工具|说明|
|------|-------------|
| `palace_auto_file` |文件结构化知识——架构决策、系统事实、人员信息、里程碑。 |

### 🕸️ 知识图谱

|工具|说明|
|------|-------------|
| `kg_add_fact` |添加a `subject → predicate → object` 事实上。可在独立模式下通过FTS5进行搜索。 |

**例子:**```
kg_add_fact: subject="alice", predicate="prefers", object="dark mode always"
kg_add_fact: subject="project-x", predicate="uses", object="React + TypeScript"

🔭 上下文引擎

工具 说明
context_startup 获取启动上下文摘要(独立内存统计数据,AgentOS模式下的完整上下文)。
context_task 搜索与特定任务相关的记忆。
context_conversation 搜索与当前主题相关的记忆。

🔧 系统

工具 说明
agent_status 运行状况检查--在独立模式下显示内存计数,在完全模式下显示服务状态。

📥 导入

工具 说明
memory_import 从ChatGPT、Claude、markdown文件或纯文本导入内存。

导入您的记忆

来自ChatGPT

  1. 转到ChatGPT→ 设置→ 数据控制→ 导出数据
  2. 下载并解压缩导出
  3. 在克劳德代码中:```
    Use memory_import with source="chatgpt" and file_path="/path/to/conversations.json"

每一次对话都变成了可搜索的记忆。

### 来自克劳德记忆文件```
Use memory_import with source="claude" and file_path="default"

读取 ~/.claude/memory/*.md --每个标题/部分都成为记忆。

从任何Markdown文件```

Use memory_import with source="markdown" and file_path="/path/to/notes.md"


按标题拆分。每个部分=一个内存。

### 从纯文本```
Use memory_import with source="text" and file_path="/path/to/notes.txt"

用双换行符分隔。每段=一段记忆。


配置

通过环境变量设置(in .mcp.json 或传递给安装程序):

变量 默认值 描述
AGENTOS_MODE full standalone 仅适用于SQLite, full 对于AgentOS
AGENTOS_URL http://localhost:8092 AgentOS API终结点(仅限完全模式)
AGENTOS_TOKEN (空) 身份验证令牌(仅限完整模式)
AGENTOS_USER_ID user 内存命名空间的用户ID
MEM0_PRIMARY_URL http://localhost:8766 Mem0主(仅全模式)
MEM0_BACKUP_URL http://localhost:8767 Mem0备份(仅限完整模式)
LOCAL_CACHE_URL http://localhost:8768 本地语义缓存(仅限完整模式)
KG_URL http://localhost:8092 知识图(仅全模式)

更改您的用户ID (对团队有用):```bash
claude mcp add \
-e AGENTOS_MODE=standalone \
-e AGENTOS_USER_ID=yourname \
-s user agentos-memory \
-- bun ~/.agentos-memory/src/index.ts


______________________________________________________________________

## 独立与全代理操作系统

### 独立模式(`AGENTOS_MODE=standalone`)

适用于 **零外部服务**.所有存储在 `~/.agentos-memory/data/memories.db`.

- ✅ 没有API密钥
- ✅ 无需互联网
- ✅ 适用于任何有面包的机器
- ✅ SQLite FTS5全文搜索
- ✅ 所有11个工具都工作
- ⚠️ 搜索基于关键字(无语义/矢量搜索)
- ⚠️ 无多代理同步

### 完全代理操作系统模式(`AGENTOS_MODE=full`)

需要跑步 AgentOS 安装。

- ✅ 三层内存搜索(本地缓存→ Mem0主→ 备份)
- ✅ 通过Qdrant进行矢量/语义搜索
- ✅ 全上下文引擎(启动数据包、任务上下文)
- ✅ 知识图(Chloe KG节点)
- ✅ 跨网格的多代理内存同步
- ✅ 带有自动分类功能的记忆宫
- ⚠️ 需要在本地运行AgentOS

______________________________________________________________________

## 数据位置```
~/.agentos-memory/
├── src/              ← MCP server source
├── data/
│   └── memories.db   ← Your memory database (back this up!)
└── node_modules/

备份你的记忆:```bash
cp ~/.agentos-memory/data/memories.db ~/memories-backup-$(date +%Y%m%d).db


**跨机器同步:**```bash
# Any file sync that handles SQLite will work:
rsync -av ~/.agentos-memory/data/memories.db user@other-machine:~/.agentos-memory/data/

手动测试

验证服务器在没有Claude Code的情况下是否正常工作:```bash

List all tools

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null \
| jq '.result.tools[].name'

Add a memory

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"memory_add","arguments":{"text":"test memory"}}}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null

Check status

echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"agent_status","arguments":{}}}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null | jq .


______________________________________________________________________

## 卸载```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/uninstall.sh | bash

或手动:```bash
claude mcp remove agentos-memory -s user
rm -rf ~/.agentos-memory


______________________________________________________________________

## 路线图

- \[ \] **托管层** --云同步+语义搜索,无需运行自己的基础设施
- \[ \] **Web用户界面** --浏览和管理您的回忆 `localhost:8765`
- \[ \] **CLAUDE.md自动注入** --自动将相关内存注入会话上下文
- \[ \] **向量搜索** --通过以下方式进行可选的本地嵌入 `llama.cpp` 或 `Ollama`
- \[ \] **记忆衰退** --自动过期陈旧记忆,增强频繁访问的记忆
- \[ \] **团队同步** --跨Claude Code实例共享内存命名空间

______________________________________________________________________

## 贡献

欢迎在 github/joemc1470/agentos-memory.```bash
# Dev setup
git clone https://github.com/joemc1470/agentos-memory.git
cd agentos-memory
bun install

# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
| AGENTOS_MODE=standalone bun src/index.ts 2>/dev/null | jq .

堆栈: TypeScript+Bun+SQLite(Bun:SQLite)+MCP SDK


许可证

麻省理工学院——随心所欲。


部分 AgentOS 项目——一个持久的、多代理的人工智能基础设施层。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Agentos Memory 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Agentos Memory 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Agentos Memory 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Agentos Memory 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Agentos Memory 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Agentos Memory 能提供哪些能力?

资料显示约 11 个工具;能力标签包括 持久化存储、本地运行、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。