xgmem MCP 内存服务器

xgmem 是一个基于 TypeScript 的模型上下文协议 (MCP) 服务器，用于为 Claude、LLM 代理和其他工具提供项目-specific 和基于知识图谱的内存支持。它支持按项目存储、检索和管理实体、关系和观察结果，重点在于灵活性和跨项目的知识共享。

功能

• 知识图谱存储，支持实体、关系和观察结果
• 通过 MCP 工具实现 CRUD 操作
• 存储到磁盘（memory.json）
• 支持 Docker 和 TypeScript

使用场景

xgmem 适用于：

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

使用方法

MCP 配置示例

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

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

安装依赖

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

npm install

构建

使用以下命令进行构建：

npm run build

开发环境运行

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

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 目录。

如何保存内存（MCP API）

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

示例 JSON：

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