Mnemosyne MCP

# Mnemosyne MCP 生產環境部署指南

## FalkorDB 生產環境優化

### Memory Overcommit 設定

FalkorDB (基於 Redis) 在生產環境中需要啟用 Memory Overcommit 以確保最佳性能：

```bash
# 1. 設定系統參數
echo 'vm.overcommit_memory = 1' | sudo tee -a /etc/sysctl.conf

# 2. 立即生效
sudo sysctl -p

# 3. 驗證設定
sysctl vm.overcommit_memory
```

### 為什麼需要 Memory Overcommit？

1. **背景保存操作**: FalkorDB 執行 BGSAVE 時會 fork() 子進程
2. **Copy-on-Write**: 子進程初期共享父進程記憶體，只在修改時複製
3. **防止失敗**: 保守的記憶體策略可能導致 fork() 失敗，影響備份

### 其他生產環境建議

```bash
# 禁用 Transparent Huge Pages (THP) - 持久化設定
# 1. 立即禁用
echo never | sudo tee /sys/kernel/mm/transparent_hugepage/enabled

# 2. 持久化設定 (重啟後生效)
echo 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' | sudo tee -a /etc/rc.local
sudo chmod +x /etc/rc.local

# 3. 或使用 systemd service (推薦)
sudo tee /etc/systemd/system/disable-thp.service > /dev/null <<EOF
[Unit]
Description=Disable Transparent Huge Pages (THP)
DefaultDependencies=false
After=sysinit.target local-fs.target
Before=mongod.service

[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo never > /sys/kernel/mm/transparent_hugepage/enabled'

[Install]
WantedBy=basic.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable disable-thp.service

# 設定 TCP backlog
echo 'net.core.somaxconn = 65535' | sudo tee -a /etc/sysctl.conf

# 設定文件描述符限制
echo 'falkordb soft nofile 65535' | sudo tee -a /etc/security/limits.conf
echo 'falkordb hard nofile 65535' | sudo tee -a /etc/security/limits.conf
```

## 監控與日誌

### 健康檢查端點

```bash
# 檢查服務健康狀態
curl http://localhost:8000/health

# 檢查 FalkorDB 連接
docker exec mnemosyne-falkordb redis-cli ping
```

### 推薦監控指標

- FalkorDB 記憶體使用率
- API 響應時間
- ECL 管線成功率
- 測試覆蓋率趨勢

## Docker 生產配置

```yaml
# docker-compose.prod.yml
version: '3.8'
services:
  falkordb:
    image: falkordb/falkordb:2.12.9  # 使用具體版本，避免 latest 標籤風險
    restart: unless-stopped
    sysctls:
      - net.core.somaxconn=65535
    ulimits:
      memlock: -1
    # Docker Compose 記憶體限制語法 (非 Swarm 模式)
    mem_limit: 4G
    mem_reservation: 2G
    # 注意: deploy.resources 僅適用於 Docker Swarm (docker stack deploy)
    # 對於 docker-compose up，請使用 mem_limit 和 mem_reservation
```