内容
# 记忆 MCP 🧠
> **为 AI 代理提供持久记忆 — 永远不需要重新解释你的项目**
[](https://www.npmjs.com/package/memory-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
## 问题
像 Claude、Cursor 和 Cline 这样的 AI 代理每次会话都从空白开始。它们会忘记你的技术栈、编码偏好、项目约定以及你昨天解释的所有内容。你最终会一次又一次地重复自己。
**memory-mcp** 通过 [模型上下文协议（MCP）](https://modelcontextprotocol.io) 为你的 AI 代理提供持久的、可搜索的记忆。只需保存一次，即可永久回忆。
## 安装
```bash
npm install -g memory-mcp
```
或在不全局安装的情况下运行：
```bash
npx memory-mcp
```
记忆存储在本地的 `~/.memory-mcp/memories.db`（SQLite）中。
## 用法
### Claude 桌面版
添加到你的 Claude 桌面版配置中：
| 操作系统 | 配置路径 |
|----|-------------|
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Linux（包括 Kali） | `~/.config/Claude/claude_desktop_config.json` |
```json
{
"mcpServers": {
"memory": {
"command": "memory-mcp"
}
}
}
```
### Cursor
添加到你的 Cursor MCP 设置（`.cursor/mcp.json` 或全局设置）：
```json
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["memory-mcp"]
}
}
}
```
### Cline
添加到你的 Cline MCP 配置：
```json
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["memory-mcp"]
}
}
}
```
更新配置后重启你的编辑器或 Claude 桌面版。
## 可用工具
| 工具 | 描述 | 参数 |
|------|-------------|------------|
| `remember` | 保存信息到记忆中 | `key`（字符串），`value`（字符串），`tags`（可选字符串） |
| `recall` | 按关键词搜索和检索记忆 | `query`（字符串） |
| `forget` | 按键删除记忆 | `key`（字符串） |
| `list_memories` | 列出所有保存的记忆 | _（无）_ |
## 示例对话
**你：** 记住这个项目使用 Next.js 14 和 TypeScript 以及 Tailwind CSS。
**代理** （调用 `remember` ）：
```json
{
"key": "项目栈",
"value": "Next.js 14，TypeScript，Tailwind CSS",
"tags": "栈，前端"
}
```
→ `记忆保存成功。键：项目栈`
---
**你：** 我们使用什么栈？
**代理** （调用 `recall` ）：
```json
{ "query": "栈" }
```
→ 找到 1 条记忆：
```
键：项目栈
值：Next.js 14，TypeScript，Tailwind CSS
标签：栈，前端
更新时间：2026-06-26 10:30:00
```
---
**你：** 显示我记住的所有内容。
**代理** （调用 `list_memories` ）：
```
2 条记忆存储：
键 | 值 | 标签 | 更新时间
---------------------------------------------------------------------------
项目栈 | Next.js 14，TypeScript，Tailwind.. | 栈，前端| 2026-06-26 10:30:00
用户偏好 | 偏好函数组件 | react，样式 | 2026-06-26 09:15:00
```
---
**你：** 忘记用户偏好。
**代理** （调用 `forget` ）：
```json
{ "key": "用户偏好" }
```
→ `记忆已删除：用户偏好`
## 开发
```bash
git clone <仓库网址>
cd memory-mcp
npm install
npm run build
npm start
```
热重载开发：
```bash
npm run dev
```
## 工作原理
- **存储：** `~/.memory-mcp/memories.db` 处的 SQLite 数据库
- **传输：** stdio（用于本地工具的标准 MCP 传输）
- **更新插入：** 使用现有键保存会更新值而不是创建重复项
- **搜索：** `recall` 匹配键和值
## 许可证
MIT
