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",