使用说明
@湖屋/记忆mcp
通过以下方式为AI助手提供持久内存 模型上下文协议(MCP).
给你的人工智能助手一个在对话中持续存在的记忆。使用 克劳德代码, 克劳德桌面版, 光标, 帆板运动,以及任何兼容MCP的客户端。
特性
- 记住 -存储事实、偏好、任务和上下文
- 召回 -语义搜索以查找相关记忆
- 忘记 -删除过时的信息
- 两种模式:
- 湖屋42 (推荐)-全语义搜索、重复数据删除、知识图谱
- 本地 -基于文件的简单存储,带有关键字搜索功能
快速开始
克劳德代码
增添 ~/.claude/claude_code_config.json:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["@lakehouse/memory-mcp"]
}
}
}
就是这样!Claude Code现在使用本地存储拥有持久内存。
配备Lakehouse 42后端(推荐)
要获得完整的语义搜索功能,请连接到Lakehouse42:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["@lakehouse/memory-mcp"],
"env": {
"LH42_URL": "https://api.lakehouse42.com",
"LH42_API_KEY": "lh42_your_api_key"
}
}
}
}
获取API密钥: 莱克豪斯42.com.
克劳德桌面版
添加到Claude Desktop的配置(设置→ 开发者→ 编辑配置):
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["@lakehouse/memory-mcp"],
"env": {
"LH42_URL": "https://api.lakehouse42.com",
"LH42_API_KEY": "lh42_your_api_key"
}
}
}
}
光标/风帆
遵循相同的模式-将MCP服务器添加到客户端的配置中。
工具
remember
储存一段记忆以备后用。
Remember that the user prefers dark mode
参数:
content(必填)-要记住的信息type-事实、偏好、任务、事件、背景、反思importance-0.0到1.0(默认值:0.5)
recall
通过语义相似性搜索记忆。
What are the user's preferences?
参数:
query(必填)-搜索内容limit-最大结果(默认值:5)types-按内存类型筛选
forget
按ID删除内存。
参数:
memoryId(必填)-要删除的内存IDreason-删除原因
list_memories
列出最近的回忆。
参数:
limit-最大结果(默认值:10)
memory_status
检查内存系统状态和后端信息。
本地vs湖屋42
| 特色 | 当地特色 | 湖屋42 |
|---|---|---|
| 坚持 | ✅ JSON文件 | ✅ 云 |
| 搜索 | 关键字匹配 | 语义(AI驱动) |
| 重复数据删除 | ❌ | ✅ 三层 |
| 知识图谱 | ❌ | ✅ 实体关系 |
| 历史跟踪 | ❌ | ✅ 完整的审计追踪 |
| 多设备同步 | ❌ | ✅ |
环境变量
| 变量 | 描述 |
|---|---|
LH42_URL |
Lakehouse42 API URL(启用LH42后端) |
LH42_API_KEY |
用于身份验证的API密钥 |
DEBUG |
启用调试日志记录(true/false) |
程序化使用
import { createMemoryServer, LH42Backend } from "@lakehouse/memory-mcp";
// Create server with custom config
const server = await createMemoryServer({
lh42Url: "https://api.lakehouse42.com",
apiKey: "lh42_xxx",
debug: true,
});
// Or use backends directly
const backend = new LH42Backend({
url: "https://api.lakehouse42.com",
apiKey: "lh42_xxx",
});
await backend.initialize();
await backend.remember({ content: "User likes TypeScript" });
const results = await backend.recall({ query: "programming preferences" });
隐私
- 本地模式:所有数据存储在
~/.lakehouse42/memory-mcp/memories.json - 湖屋42模式:数据安全地存储在您的Lakehouse42帐户中
- 不向第三方发送数据
- 你控制你的记忆
许可证
麻省理工学院