【技术文档摘要】：

xgmem MCP 内存服务器

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

功能

• 实体、关系和观察结果的知识图谱存储
• 通过 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 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 在 2021 年加入 Acme Corp。",
          "Alice 是一名软件工程师。"
        ]
      },
      {
        "entityName": "Bob",
        "contents": [
          "Bob 在 2022 年加入 Acme Corp。",
          "Bob 是一名产品经理。"
        ]
      }
    ]
  }
}

您可以使用任何兼容的 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