MCP Memory Enhanced

MCP内存增强

 ](https://github.com/JamesPrial/mcp-memory-enhanced/actions/workflows/docker-publish.yml) ](https://github.com/JamesPrial/mcp-memory-enhanced/releases)  

增强型叉子 MCP内存服务器 SQLite后端支持可提高性能和可扩展性。 现在是v1.0.0-生产就绪！ 🚀

🚀 特性

• 双存储后端：在JSON（原始）和SQLite存储之间进行选择
• 3-10x性能改进：SQLite后端提供了显著的速度提升
• 生产就绪Docker支持：多阶段构建、运行状况检查和UnRAID兼容性
• 向后兼容：与原始MCP协议100%兼容
• 迁移工具：从JSON无缝迁移到SQLite存储

📊 性能比较

基于10000多个实体的基准：

🐳 Docker快速入门

docker run -d \
  --name mcp-memory-enhanced \
  -p 6970:6970 \
  -v /path/to/data:/data \
  -e STORAGE_TYPE=sqlite \
  ghcr.io/jamesprial/mcp-memory-enhanced:latest

📦 安装

来自npm（通过GitHub）

# Latest version
npm install github:JamesPrial/mcp-memory-enhanced

# Specific version
npm install github:JamesPrial/mcp-memory-enhanced#v1.0.0

来源

git clone https://github.com/JamesPrial/mcp-memory-enhanced.git
cd mcp-memory-enhanced
npm install
npm run build

使用Docker Compose

docker-compose up -d

🔧 配置

环境变量

MCP配置

添加到MCP客户端设置中：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/mcp-memory-enhanced/dist/index.js"],
      "env": {
        "STORAGE_TYPE": "sqlite",
        "STORAGE_PATH": "/path/to/data"
      }
    }
  }
}

🔄 从JSON到SQLite的迁移

# Using the migration tool
npm run migrate /path/to/knowledge-graph.jsonl

或者使用Docker：

docker run --rm \
  -v /path/to/json-data:/source \
  -v /path/to/sqlite-data:/data \
  ghcr.io/jamesprial/mcp-memory-enhanced:latest \
  node dist/migrate.js /source/knowledge-graph.jsonl

🏥 健康检查（仅限Docker）

Docker容器在以下位置提供了一个健康端点 http://localhost:6970/health:

{
  "status": "healthy",
  "timestamp": "2025-08-05T12:00:00.000Z",
  "storage": {
    "type": "sqlite",
    "stats": {
      "entityCount": 1000,
      "relationCount": 500,
      "observationCount": 2000,
      "storageSize": 1048576
    }
  }
}

🚀 UnRAID部署

1. 下载 UnRAID模板
2. 在UnRAID web UI中：Docker→ 添加容器→ 模板
3. 选择模板文件并根据需要进行配置

🛠️ 发展

运行测试

npm test

构建Docker镜像

docker build -f Dockerfile.standalone -t mcp-memory-enhanced .

本地运行

STORAGE_TYPE=sqlite npm start

📈 建筑

增强型MCP内存服务器使用干净的存储抽象层：

┌─────────────────┐
│   MCP Client    │
└────────┬────────┘
         │ stdio
┌────────▼────────┐
│   MCP Server    │
│   (index.ts)    │
└────────┬────────┘
         │
┌────────▼────────┐
│ KnowledgeGraph  │
│    Manager      │
└────────┬────────┘
         │
┌────────▼────────┐
│ IStorageBackend │
└────────┬────────┘
         │
    ┌────┴────┐
    │         │
┌───▼───┐ ┌──▼────┐
│ JSON  │ │SQLite │
└───────┘ └───────┘

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支(git checkout -b feat/amazing-feature)
3. 提交您的更改(git commit -m 'feat: add amazing feature')
4. 推到分支(git push origin feat/amazing-feature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 原创 MCP内存服务器 通过Anthropic
• 与 MCP TypeScript SDK
• 由...驱动 更好平方3

📊 状态

• 第一阶段：✅ 核心实施（完成）
• 第二阶段：✅ Docker支持（完整）
• 第三阶段：✅ CI/CD管道（完整）
• 第四阶段：🔄 生产硬化（下）

______________________________________________________________________

🤖 通过以下方式增强了生产使用❤️ 靠近 @詹姆斯·普里阿尔