Semantic Memory MCP Server

语义记忆MCP服务器

RWIF是共振波信息格式的缩写，它将语义内存转化为紧凑、可移植的文件，这些文件可以保留在磁盘上，而不是强制重量级矢量数据库驻留在RAM或VRAM中。该存储库通过干净的MCP服务器公开磁盘本机内存，因此模型和代理可以从SSD、可移动介质或混合存储层上的RWIF文件中检索基于语义的证据，而无需引入单独的数据库平台。

实际含义很简单：语义检索变成了一个文件和路由器问题，而不是一个集群和索引问题。您可以在本地SSD上始终保持知识，只在需要时挂载私有知识，并在所有知识上发布一个稳定的MCP表面。

为何存在此回购

• 用RWIF支持的语义记忆文件替换通常的矢量数据库控制平面。
• 通过一个MCP工具表面在多个商店之间布线。
• 保持每个存储区的存储策略明确 read-only 和 read-write 模式。
• 允许语义内存存在于正常的文件系统上，包括可移动或加密介质。
• 保留出处、修订、矛盾和受管理的编写工作流程。

所得

• MCP工具 memory_query, memory_answer, memory_reason以及店铺管理。
• 跨多个RWIF语义内存存储的联合路由。
• 通过JSON使用可移植根目录和相对存储路径进行存储配置。
• 在代理层强制执行每店突变策略。
• Docker、Docker Compose和Docker Desktop示例配置。
• 中的一个小型演示RWIF工件 sample_data/demo_readme_semantic_store.rwif.

仓库的规划

看 中继器_布局.md 为清洁的出口树。

发布操作

使用 发布_cECKLIST.md 在推到公共遥控器或切断发布之前。使用 TAG_准备.md 在准备第一个版本标签时。

基准测试

看 基准.md 对于初始发布基准记录。当前基准页面包括：

• RWIF检索微观基准
• 专用RWIF与密集余弦存储方法基准
• 基于真实文本导出数组数据集的专用RWIF与密集余弦工作负载形状基准
• 具有确定性文本派生激活的更大的已发布文本语料库基准
• 基于README的语义内存演示快照
• 更广泛的语义验证器展示了开发验证的快照

使用一个命令重新生成已发布的比较基准工件：

python scripts/regenerate_benchmark_artifacts.py

快速开始

安装具有运行时依赖项的包：

pip install ".[runtime]"

运行聚焦测试套件：

python -m unittest tests.test_semantic_memory_federation

在本地针对附带的演示商店运行服务器：

python scripts/semantic_memory_mcp_server.py \
  --federated-config sample_data/demo_local_federated_memory_config.json \
  --default-active-store repo-demo \
  --semantic-provider-warmup startup

本地配置指向包含的演示RWIF文件，用于开箱即用的验证。Docker和Docker桌面示例使用 sample_data/demo_federated_memory_config json，这是为已安装的容器路径编写的。

核心MCP工具

• memory_list_stores
• memory_set_active_stores
• memory_status
• memory_get
• memory_query
• memory_answer
• memory_reason

写治理工具也可用：

• memory_list_proposals
• memory_list_proposal_events
• memory_propose
• memory_review_proposal
• memory_commit_proposal

存储模型

RWIF语义内存存储是通过JSON配置的。每家商店都可以申报：

• 中的根目录名称 store_roots
• 一 relative_path 根下
• 一 access_mode 的 read-only 或 read-write
• 可选的可移动媒体元数据

最小模式：

{
  "store_roots": {
    "always-on": "/data/stores",
    "removable": "/data/removable"
  },
  "stores": [
    {
      "store_id": "repo-demo",
      "root": "always-on",
      "relative_path": "demo_readme_semantic_store.rwif",
      "access_mode": "read-write"
    },
    {
      "store_id": "personal-removable",
      "root": "removable",
      "relative_path": "personal_records_demo.rwif",
      "access_mode": "read-only"
    }
  ]
}

码头工人

塑造形象：

docker build -t semantic-memory-mcp-server:latest .

使用已挂载的配置和存储目录运行：

docker run --rm -i \
  -e SEMANTIC_MEMORY_CONFIG=/data/config/demo_federated_memory_config.json \
  -e DEFAULT_ACTIVE_STORES=repo-demo \
  -v "$PWD/sample_data:/data/config:ro" \
  -v "/ABSOLUTE/PATH/TO/stores:/data/stores:ro" \
  -v "/ABSOLUTE/PATH/TO/removable:/data/removable:ro" \
  semantic-memory-mcp-server:latest

包括 显示了相同的模式。

Docker桌面示例

包括两个示例设置文件：

• ：config和存储以只读方式挂载
• ：config以只读方式挂载，可移动/私有根以只读方式装载，主存根以读写方式装载

可写示例有意缩小范围。仅标记的商店 access_mode: read-write 可以发生变异，并且只有底层挂载也是可写的。

安全

阅读 安全.md 在将写工具暴露给外部客户端之前。简短的版本是：写访问是本地功能，而不是外观标志。

包括样本资产

• sample_data/demo_local_federated_memory_config json
• sample_data/demo_federated_memory_config json
• sample_data/demo_readme_semantic_store.rwif
• 示例数据/基准文本记录array.jsonl
• sample_data/benchmark_text_queries_array.jsonl
• 样本数据/基准文本校准数组jsonl
• sample_data/benchmark_text_large_records.jsonl
• sample_data/benchmark_text_large_queries.jsonl
• sample_data/benchmark_text_large_calibration.jsonl
• sample_data/research_notes_sample.jsonl
• 样本_数据/个人_记录_样本.jsonl

范围

此存储库有意缩小范围。它封装了MCP语义记忆服务器及其所依赖的RWIF运行时。它不包括原始monorepo中更广泛的研究和应用框架。

相关项目

有关编写、验证、区分和修补RWIF语义记忆工件，请参阅配套仓库：

rwif构建器