@卡地亚/英格拉姆mcp
人工智能代理的持久语义记忆——MCP服务器 @Cartisien/Engram
为任何兼容MCP的AI客户端(Claude Desktop、Cursor、Windsurf)提供跨会话生存的持久内存。
npx -y @cartisien/engram-mcp______________________________________________________________________
它做什么
向任何MCP客户端公开5个工具:
| 工具 | 说明 |
|---|---|
remember | 存储具有自动嵌入功能的内存 |
recall | 跨存储记忆的语义搜索 |
history | 最近的对话历史 |
forget | 删除日期前的一个内存、一个会话或条目 |
stats | 会话的内存统计信息 |
内存存储在SQLite中。语义搜索使用本地Ollama嵌入(nomic-embed-text)-没有API密钥,没有云。如果Ollama不可用,则返回关键字搜索。
______________________________________________________________________
快速开始
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "@cartisien/engram-mcp"],
"env": {
"ENGRAM_DB": "~/.engram/memory.db"
}
}
}
}重新启动克劳德桌面。你会看到 remember, recall, history, forget,以及 stats 可用作工具。
光标/风帆
添加到MCP配置中:
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "@cartisien/engram-mcp"]
}
}
}______________________________________________________________________
配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
ENGRAM_DB | ~/.engram/memory.db | SQLite数据库路径 |
ENGRAM_EMBEDDING_URL | http://localhost:11434 | Ollama嵌入的基本URL |
局部嵌入(推荐)
安装 奥拉玛 并拉取嵌入模型:
ollama pull nomic-embed-text语义搜索会自动激活。如果没有Ollama,则使用关键字搜索。
______________________________________________________________________
示例用法
连接后,您的代理可以:
remember(sessionId="myagent", content="User prefers TypeScript over JavaScript", role="user")
recall(sessionId="myagent", query="what are the user's coding preferences?", limit=5)
# Returns: [{ content: "User prefers TypeScript...", similarity: 0.82 }, ...]
history(sessionId="myagent", limit=10)
stats(sessionId="myagent")
# { total: 42, byRole: { user: 20, assistant: 22 }, withEmbeddings: 42 }______________________________________________________________________
Cartisien记忆套件的一部分
@cartisien/engram--核心内存SDK@cartisien/engram-mcp--此软件包,MCP服务器@cartisien/extensa--矢量基础设施 *(即将推出)*@cartisien/cogito--代理身份和生命周期 *(即将推出)*
______________________________________________________________________
MIT© Cartisien互动
