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