Zmem

🚀 xgmem MCP 内存服务器

xgmem 是一款基于 TypeScript 的模型上下文协议（MCP）服务器，它能为 Claude、LLM 代理及其他工具提供项目特定且基于知识图谱的内存支持。该服务器支持按项目存储、检索和管理实体、关系与观察结果，着重于灵活性和跨项目的知识共享。

✨ 主要特性

• 知识图谱存储：支持存储实体、关系和观察结果。
• CRUD 操作：可通过 MCP 工具实现创建、读取、更新和删除操作。
• 磁盘存储：能将数据存储到磁盘（memory.json）。
• 多环境支持：支持 Docker 和 TypeScript。

📦 安装指南

安装依赖

运行以下命令安装所有依赖项：

npm install

构建

使用以下命令进行构建：

npm run build

💻 使用示例

MCP 配置示例

在你的 MCP 配置文件（例如 windsurf）中添加：

"mcpServers": {
    "xgmem": {
      "command": "npx",
      "args": ["-y", "xgmem@latest"]
    }
  }
}

开发环境运行

在开发环境中运行服务器：

npx ts-node index.ts

生产环境运行

在生产环境中运行：

npm start

Docker 部署

使用以下命令构建 Docker 镜像：

docker build -t xgmem-mcp-server .

运行容器并挂载持久化存储卷：

docker run -v $(pwd)/memories:/app/memories xgmem-mcp-server

这样，所有项目的内存文件都会被持久化到主机的 memories 目录。

📚 详细文档

使用场景

xgmem 适用于以下场景：

• 需要存储和检索结构化内存的代理和 LLM，例如实体、关系和观察结果。
• 跨项目知识共享与迁移。
• 可扩展、持久化磁盘存储以及查询的代理生态系统。

如何保存内存（MCP API）

要为项目保存观察结果，可以通过调用 MCP API 的 save_project_observations 工具： 示例 JSON：

{
  "name": "save_project_observations",
  "args": {
    "projectId": "demo-project",