slopnesia (Jjtolton)

斯洛普尼亚

具有可选嵌入的最小MCP内存服务器- 总计300MB以下 （基于PyTorch的替代品为900MB+）。

特性

• 基于界面的设计 -轻松交换嵌入提供者
• 自动回退 -尝试ONNX/GPU→ ONNX/CPU→ OpenAI API→ 文本搜索
• SQLite存储 -单文件数据库位于 ~/.claude/memories.db
• 最小依赖性 -28个基本包，总共48个ONNX包
• 多代理保险箱 -CouchDB风格的版本向量乐观并发控制
• 单作者队列 -序列化写入防止竞争条件

安装

先决条件

• Python 3.11或更高版本
• uv 包管理器(在此处安装)

1.克隆存储库

cd ~/programs  # or wherever you want to install it
git clone https://github.com/jjtolton/slopnesia
cd slopnesia

2.选择您的安装

基本安装（仅限文本搜索）

uv pip install -e .

大小：~10MB

ONNX嵌入（本地，GPU加速）

uv pip install -e '.[onnx]'

大小：总计约300MB（ONNX运行时GPU+型号）

OpenAI嵌入（基于API）

uv pip install -e '.[api]'

大小：~15MB

配置

设置环境变量：

# 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 全局安装命令：

claude mcp add --scope user simple-memory uv --directory /path/to/slopnesia run python -m src.server

替换 /path/to/slopnesia 根据您的实际安装路径（例如。， ~/programs/slopnesia).

验证安装：

claude mcp list

手动配置

或者，编辑您的 ~/.claude/mcp.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替代品）

比较

多代理并发

Slopenesia支持多个代理的安全并发访问。看 混凝土.md 有关以下内容的详细信息：

• 版本向量和内容哈希
• 带有冲突检测的乐观锁定
• 单写入器队列架构
• 冲突解决工作流程

测试实现：

uv run python test_concurrency.py

发展

见实施文件：

• src/embeddings.py -嵌入接口和实现
• src/database.py -带FTS5+版本控制的SQLite存储
• src/config.py -配置和自动检测
• src/server.py -MCP服务器实现
• test_concurrency.py -并发控制测试套件