server-noonien - shared memory MCP Server已验证已精选

什么是 server-noonien MCP Server？

server-noonien MCP Server 是一个面向 AI 智能体的共享、无服务器、无冲突的记忆系统。它可以直接替换官方的 @modelcontextprotocol/server-memory 知识图谱，拥有相同的实体、观察、关系和九个工具，并且无需中央服务器或数据库就能在多台机器之间保持同步。

官方记忆服务器只维护一个 JSONL 文件，每次修改都要重写整个文件，因此通过同步文件夹共享时可能悄无声息地丢失写入。server-noonien 则为每台机器分配一个只追加的分片，读取时再把所有分片合并成一张图。这张图是一个 CRDT（按混合逻辑时钟排序的 LWW-Element-Set），所以合并永远不会冲突。分片可以通过内置的 nooniend 守护进程点对点传输（经由 Tailscale、WireGuard 或普通局域网），也可以通过你已有的文件夹或 S3 兼容存储桶传输。它以 MPL-2.0 开源，在 npm 上以 server-noonien 发布，需要 Node.js 22 或更高版本。

如何使用 server-noonien MCP Server？

服务器通过 stdio 使用 MCP，不需要任何参数，由客户端负责启动。在单台机器上无需额外设置即可使用。README 中的配置把它注册为 memory，因此可以替换现有的官方记忆服务器，而智能体无需任何改动。

Claude Code

claude mcp add memory -- npx -y server-noonien

Claude Desktop

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "server-noonien"],
      "env": { "NOONIEN_DIR": "~/.noonien" }
    }
  }
}

Cursor

把同样的 mcpServers 条目放入 ~/.cursor/mcp.json。

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "server-noonien"],
      "env": { "NOONIEN_DIR": "~/.noonien" }
    }
  }
}

在多台机器间共享记忆

为每台机器设置唯一的 NOONIEN_NODE_ID（默认为主机名），并在每台机器上运行一个 nooniend 守护进程：

npm install -g server-noonien
NOONIEN_DIR=~/.noonien NOONIEND_TAILSCALE=true nooniend

不使用 Tailscale 时，可以用 NOONIEND_PEERS=host:27878 指定一个可达的种子节点，或使用 NOONIEND_DNS_SRV。如果想改用共享存储，可设置 NOONIEN_BACKEND=file 并指向同步文件夹，或设置 NOONIEN_BACKEND=s3 并配置 NOONIEN_S3_BUCKET。

要迁移现有的官方记忆文件，运行 noonien import memory.jsonl。

server-noonien MCP Server 的主要功能

• 与官方记忆服务器逐个工具兼容：名称、输入和输出都相同。
• 每台机器有一个单写入者分片，两个节点永远不会写同一个文件。
• 合并满足幂等、交换和结合律。任何两个见过相同操作的节点都持有完全相同的图。
• 本地优先，可离线使用，网络恢复后网格会自动追上。
• 点对点同步无需共享文件夹或托管服务，并支持基于每节点证书的 mTLS。
• 提供带更新通知的 memory://knowledge-graph 资源。
• 附带 noonien 维护 CLI（import、export、merge、compact、query），守护进程提供 Prometheus 指标。

server-noonien MCP Server 工具

• 官方九个工具：create_entities、create_relations、add_observations、delete_entities、delete_observations、delete_relations、read_graph、search_nodes 和 open_nodes。read_graph 和 search_nodes 还支持可选分页，search_nodes 支持 entityType 过滤。
• 扩展工具：update_entities 重命名实体或修改其类型；update_observations 替换观察内容；update_relations 修改关系的类型或端点；merge_entities 把一个实体合并到另一个；read_conflicts 列出被多个节点写过的元素及其作者。

server-noonien MCP Server 的使用场景

• 笔记本和台式机共用一份记忆：“记住 staging 数据库已迁移到 db2.internal。”然后在另一台机器上调取。
• 通过 VPN 组建团队网格：多位开发者的智能体共享项目信息，无需托管的记忆产品。
• 清理重复项：“把实体 ‘JS’ 合并到 ‘JavaScript’。”
• 审查冲突：“显示两台机器都写过的记忆元素。”
• 迁移：导入现有的 server-memory JSONL 文件，继续使用相同的工具。

server-noonien MCP Server 与替代方案对比

与官方 server-memory 相比，server-noonien 支持多台机器，并且可以安全地通过同步文件夹共享，因为它是追加写入而不是重写整个文件。两者都不需要服务器或云账号。与托管记忆服务相比，它不需要账号，存储保留在你自己的机器或存储桶上。它使用显式知识图谱，而不是向量检索。

server-noonien MCP Server 常见问题排查

• 两台机器的写入奇怪地交错：每台机器都需要唯一的 NOONIEN_NODE_ID，同一时间只能有一个服务器以该 ID 写入。
• 守护进程互相找不到：配置一个发现源（NOONIEND_TAILSCALE、NOONIEND_DNS_SRV 或 NOONIEND_PEERS），并确保所有节点使用同一个端口。自 1.0.3 起默认端口为 27878。
• nooniend 拒绝启动：它只复制目录，因此不能在 NOONIEN_BACKEND=s3 或 memory 下运行。
• S3 写入失败：存储必须支持条件写入（If-Match/If-None-Match）。AWS S3、Cloudflare R2 和 MinIO 都支持。