分布式向量内存服务

PluresLM MCP是一个为AI助手提供持久化向量内存和P2P同步的分布式服务。

  • by plures
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 plures/superlocalmemory-mcp

使用说明

PlusLM MCP服务

由PluresDB支持的人工智能助手的分布式矢量存储服务。

PluresLM MCP提供具有跨设备P2P同步的持久矢量存储器。建于 PlusDB 对于分布式数据和 模型上下文协议 用于AI工具集成。

特性

  • 🧠 持久矢量存储器 -跨对话历史的语义搜索
  • 🌐 P2P同步 -通过Hyperswarm跨设备共享记忆
  • 🔧 MCP协议 -AI助手集成的标准接口
  • 🚀 多个传输 -stdio、SSE/HTTP用于不同的部署需求
  • 📦 零知识 -无中央服务器,加密P2P网格
  • 🛠️ 项目索引 -摄取代码库以获得上下文感知帮助

快速开始

地方发展(stdio)

npm install
npm run build

# Set PluresDB topic (generate with: openssl rand -hex 32)
export PLURES_DB_TOPIC="your-64-char-hex-topic-key"

# Start stdio MCP server
npm start

远程服务(HTTP/SSE)

# Configure for HTTP transport
export MCP_TRANSPORT=sse
export PORT=3001
export HOST=0.0.0.0
export PLURES_DB_TOPIC="your-topic-key"

# Start HTTP service
npm start
# → Serving on http://0.0.0.0:3001/sse

配置

环境变量

变量 必填 描述
PLURES_DB_TOPIC ✅ PluresDB网格的64个字符十六进制字符串(32字节)
PLURES_DB_SECRET ❌ 网格的可选加密密钥
MCP_TRANSPORT ❌ stdio (默认)或 sse 对于HTTP
PORT ❌ 使用SSE传输时的HTTP端口(默认值:3001)
HOST ❌ HTTP主机(默认值:0.0.0.0)
OPENAI_API_KEY ❌ 用于嵌入的OpenAI密钥(回退到本地Transformers.js)
OPENAI_EMBEDDING_MODEL ❌ OpenAI模型名称(默认:text-embedding-3-small)
PLURES_LM_DEBUG ❌ 启用调试日志记录(true/false)

OpenClaw集成

本地(stdio):

{
  "mcpServers": {
    "pluresLM": {
      "command": "node", 
      "args": ["path/to/pluresLM-mcp/dist/index.js"],
      "env": {
        "PLURES_DB_TOPIC": "your-topic-key"
      }
    }
  }
}

远程(SSE):

{
  "mcpServers": {
    "pluresLM": {
      "transport": {
        "type": "sse",
        "url": "http://memory-service:3001/sse" 
      }
    }
  }
}

建筑

PlusDB后端

PlusLM v2.0+使用 纯PlusDB 用于存储和同步:

  • 无SQLite依赖关系 -分布式优先设计
  • 超温P2P网格 -直接设备间同步
  • 嵌入式矢量搜索 -记忆中的余弦相似性
  • 无冲突复制 -分布式一致性的CRDT

运输选项

  1. 标准 (默认)-用于本地OpenClaw集成的过程管道
  2. SSE -远程/集群部署的服务器通过HTTP发送事件

内存同步

共享相同内容的所有设备 PLURES_DB_TOPIC 自动同步内存:

# Device 1
export PLURES_DB_TOPIC="abc123..." 
npm start  # Stores memories locally

# Device 2  
export PLURES_DB_TOPIC="abc123..."  # Same topic
npm start  # Automatically receives Device 1's memories

工具

PluresLM MCP为AI助手提供了以下工具:

  • pluresLM_store(content, tags?, category?, source?) -存储新内存
  • pluresLM_search(query, limit?, minScore?) -语义搜索
  • pluresLM_forget(id? | query?, threshold?) -删除记忆
  • pluresLM_index(directory, maxFiles?, category?, tags?) -索引代码库
  • pluresLM_status() -数据库统计数据+同步状态
  • pluresLM_profile() -用户配置文件数据

部署

连接msWork车队

对于跨多个OpenClaw实例的企业部署:

# Memory service (dedicated server)
docker run -p 3001:3001 -e MCP_TRANSPORT=sse plures/pluresLM-mcp

# Worker instances (point to service)
export MCP_TRANSPORT=sse
export PLURES_LM_SERVICE_URL=http://memory-service:3001/sse

高可用性

# Multiple services with shared PluresDB topic
docker-compose up -d  # Load balancer → N service instances

从v1.x迁移

PlusLM v2.0是一个 重大变更 基于SQLite的v1.x版本:

发生了什么变化

  • ❌ 移除:所有SQLite/better-squite3依赖项
  • ✅ 添加:PlusDB分布式存储
  • ✅ 添加:P2P网格同步
  • ✅ 添加:SSE/HTTP传输选项
  • 🔄 改变:工具名称(memory_* → pluresLM_*)
  • 🔄 改变:配置(文件路径→ 主题键)

迁移路径

  1. 导出v1.x数据: pluresLM_export_bundle
  2. 使用PlusDB主题部署v2.0
  3. 导入数据: pluresLM_import_bundle

注意:由于架构差异,不支持直接文件迁移。

许可证

双重许可 BSL-1.1 和 麻省理工学院。您可以选择任何一种许可证。

链接