斯洛普尼亚
具有可选嵌入的最小MCP内存服务器- 总计300MB以下 (基于PyTorch的替代品为900MB+)。
特性
- 基于界面的设计 -轻松交换嵌入提供者
- 自动回退 -尝试ONNX/GPU→ ONNX/CPU→ OpenAI API→ 文本搜索
- SQLite存储 -单文件数据库位于
~/.claude/memories.db - 最小依赖性 -28个基本包,总共48个ONNX包
- 多代理保险箱 -CouchDB风格的版本向量乐观并发控制
- 单作者队列 -序列化写入防止竞争条件
安装
先决条件
- Python 3.11或更高版本
uv包管理器(在此处安装)
1.克隆存储库```bash
cd ~/programs # or wherever you want to install it
git clone https://github.com/jjtolton/slopnesia
cd slopnesia
### 2.选择您的安装
**基本安装(仅限文本搜索)**```bash
uv pip install -e .
大小:~10MB
ONNX嵌入(本地,GPU加速)```bash
uv pip install -e '.[onnx]'
大小:总计约300MB(ONNX运行时GPU+型号)
**OpenAI嵌入(基于API)**```bash
uv pip install -e '.[api]'
大小:~15MB
配置
设置环境变量:```bash
Embedding mode (auto, onnx, openai, none)
MEMORY_EMBEDDING_MODE=auto
ONNX settings
MEMORY_ONNX_MODEL=all-MiniLM-L6-v2
MEMORY_ONNX_USE_GPU=true
OpenAI settings
MEMORY_OPENAI_API_KEY=sk-...
MEMORY_OPENAI_MODEL=text-embedding-3-small
Database location
MEMORY_DB_PATH=~/.claude/memories.db
## MCP配置
要使Claude能够使用slopenesia进行内存存储,请将此MCP服务器添加到您的配置中:
### 适用于Claude Code CLI
使用 `claude mcp` 全局安装命令:```bash
claude mcp add --scope user simple-memory uv --directory /path/to/slopnesia run python -m src.server
替换 /path/to/slopnesia 根据您的实际安装路径(例如。, ~/programs/slopnesia).
验证安装:```bash
claude mcp list
### 手动配置
或者,编辑您的 `~/.claude/mcp.json`:```json
{
"mcpServers": {
"simple-memory": {
"command": "uv",
"args": [
"--directory",
"/path/to/slopnesia",
"run",
"python",
"-m",
"src.server"
],
"env": {
"MEMORY_EMBEDDING_MODE": "auto",
"MEMORY_ONNX_USE_GPU": "true"
}
}
}
}
添加配置后,重新启动Claude Code。
MCP工具
服务器向Claude公开这些工具:
store_memory(content, tags?, context?)-存储新内存(返回版本和哈希值)search_memory(query, limit?, threshold?)-使用文本或语义相似性进行搜索list_recent(limit?)-获取最近的回忆get_memory(id)-通过ID和版本信息获取特定内存update_memory(id, content, expected_version, expected_hash?, tags?, context?)-更新冲突检测delete_memory(id)-删除内存get_stats()-获取数据库统计信息restart_server()-优雅地重新启动MCP服务器
建筑```
┌─────────────────────────────────┐
│ EmbeddingProvider Interface │
└────────────┬────────────────────┘
│
┌───────┴───────┬────────────┬──────────┐
│ │ │ │
┌────▼────┐ ┌─────▼─────┐ ┌──▼────┐ ┌──▼─────┐
│ NoOp │ │ ONNX │ │OpenAI │ │ Future │
│(text) │ │(local GPU)│ │(API) │ │providers│
└─────────┘ └───────────┘ └───────┘ └────────┘
## 当前状态
✓ **已安装并连接到Claude Code**
**嵌入提供程序:** 自动检测(带GPU回退的ONNX)
**数据库:** `~/.claude/memories.db`
**总大小:** 约300MB(ONNX)与900MB+(PyTorch替代品)
## 比较
|特征|斜坡病|克劳德·库索尔记忆MCP|
|---------|-------------------|------------------------|
|大小|300MB(ONNX)|900MB+(PyTorch)|
|依赖关系|48个包|339个包|
|存储| SQLite(单文件)| PostgreSQL+Redis(Docker)|
|GPU支持|是(ONNX运行时)|是(PyTorch CUDA)|
|嵌入|ONNX、OpenAI或无|PyTorch仅限本地|
|安装|简单pip安装| Docker编写+Python环境|
## 多代理并发
Slopenesia支持多个代理的安全并发访问。看 混凝土.md 有关以下内容的详细信息:
- 版本向量和内容哈希
- 带有冲突检测的乐观锁定
- 单写入器队列架构
- 冲突解决工作流程
测试实现:```bash
uv run python test_concurrency.py
发展
见实施文件:
src/embeddings.py-嵌入接口和实现src/database.py-带FTS5+版本控制的SQLite存储src/config.py-配置和自动检测src/server.py-MCP服务器实现test_concurrency.py-并发控制测试套件
