xgmem MCP Memory Server

xgmem MCP 记忆服务

xgmem 是一个基于 TypeScript 的模型上下文协议（MCP）服务，可为 Claude、大模型 Agent 和其他工具启用项目专属的知识图谱记忆。它支持按项目存储、检索和管理实体、关系及观察记录，注重灵活性和跨项目知识共享。

功能

• 用于存储实体、关系和观察记录的知识图谱
• 通过 MCP 工具执行 CRUD 操作
• 持久化到磁盘（memory.json）
• 支持 Docker 和 TypeScript

使用场景

xgmem 适用于：

• 需要按项目存储和检索结构化记忆（实体、关系、观察记录）的 Agent 和大模型。
• 跨项目知识共享和迁移。
• 为 Agent 生态系统提供可扩展、持久化到磁盘且可查询的记忆。

用法

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 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",
    "observations": [
      {
        "entityName": "Alice",
        "contents": [
          "Alice joined Acme Corp in 2021.",
          "Alice is a software engineer."
        ]
      },
      {
        "entityName": "Bob",
        "contents": [
          "Bob joined Acme Corp in 2022.",
          "Bob is a product manager."
        ]
      }
    ]
  }
}

你可以使用任何兼容的 MCP 客户端；如果直接运行服务，也可以通过标准输入发送此 JSON。

工具和 API

xgmem 提供以下工具：

• save_project_observations
• get_project_observations
• add_graph_observations
• create_entities
• create_relations
• delete_entities
• delete_observations
• delete_relations
• read_graph
• search_nodes
• search_all_projects
• open_nodes
• copy_memory

如果已启用，请参阅 get_help 工具，获取通过 MCP API 使用的文档和示例。

配置

• 设置 MEMORY_DIR_PATH 环境变量以更改记忆存储目录（默认值：/app/memories）。

许可证

MIT