This release adds 2 notable features for engineering teams evaluating rollout.
✓ No known CVEs patched in this version
Topics
+14 more
Summary
AI summaryPrevents Ollama Vision out‑of‑memory errors by unloading the model at three stages and adds Apple Silicon Metal GPU detection.
Full changelog
ReftrixMCP v0.1.2 — Apple Metal対応 & Vision OOM防止 / Apple Metal Support & Vision OOM Prevention
Apple Silicon Metal GPU検出を追加し、Ollama Vision OOMを3箇所アンロードで防止。バックアップ認証やQuickstartセットアップも改善。
Added Apple Silicon Metal GPU detection and 3-point Ollama Vision unload to prevent OOM. Also fixed backup authentication and improved quickstart setup.
新機能 / New Features
- Apple Silicon Metal GPU detection / Apple Silicon Metal GPU検出
GpuVendorenum (NVIDIA | APPLE_METAL | UNKNOWN) for GPU vendor identification / GPUベンダー識別用の列挙型HardwareDetector.isAppleSilicon()static method (process.platform + process.arch, no external commands) / 外部コマンド不使用の静的メソッド- Ollama
/api/psreports Unified Memory assize_vram > 0, so existing GPU detection works correctly / Unified Memoryをsize_vram > 0として報告するため既存GPU判定で正しく動作 - 10 new tests (8 hardware-detector + 2 readiness-probe) / テスト10件追加
- SEC/TDA/LCC 3-agent audit passed / SEC/TDA/LCC 3エージェント監査通過
- NOTICE file with Apple trademark attribution (per LCC audit) / Apple商標帰属表示のNOTICEファイル(LCC監査推奨)
修正 / Fixes
- Docker Compose backup authentication failure / Docker Composeバックアップ認証失敗
env_filetwo-stage loading (.env.exampledefaults →.env.localoverrides) /env_file2段階読み込み- Auth pre-flight check (
pg_isready+psql SELECT 1) indb-backup.sh/db-restore.sh/ 認証事前チェック追加 - Container-mode support (
REFTRIX_BACKUP_INSIDE_CONTAINER=true) / コンテナ内モード対応
- Quickstart setup completeness / Quickstartセットアップの完全性
- Added
pnpm exec playwright install chromium/ Playwrightブラウザ依存追加 - Ollama promoted from optional to required prerequisite / Ollamaをオプションから必須に昇格
- Added
NODE_ENVandOLLAMA_BASE_URLto MCP config example / MCP設定例に環境変数追加
- Added
- Ollama Vision OOM prevention (3-point unload) / Ollama Vision OOM防止(3箇所アンロード)
- Unloads Vision model via
keep_alive: "0"at 3 points: (1) after Phase 1, (2) after Phase 2.5, (3) after Phase 4 / 3箇所でVisionモデルをアンロード - Frees ~10.6 GB on CPU-only (16 GB RAM) / CPU-only環境で~10.6GB解放
- Phase 1 unload also fixes Phase 2.5 skip on GPU environments / Phase 1アンロードでGPU環境のPhase 2.5スキップも解消
- Idempotent; SSRF-safe via
validateOllamaLocalhostUrl()/ 冪等; SSRF対策済み
- Unloads Vision model via
- Default mode
visionUsed: false-- was incorrectly set even when Vision was used / デフォルトモードでVision使用時もfalseになっていた - CPU-only scroll vision timeout -- scroll vision analysis timed out prematurely on CPU environments / CPU環境でスクロールVision分析が早期タイムアウト
ドキュメント / Documentation
- Updated
current-architecture.md: HardwareDetector (GpuVendor, isAppleSilicon, Unified Memory), Database Backup & Restore / HardwareDetector・バックアップセクション更新 - Added troubleshooting: Backup auth failure, Vision OOM, Apple Silicon nvidia-smi / トラブルシューティング追加
- Updated all user guides (getting-started, mcp-tools-guide, page-analyze-deep-dive) / 全ユーザーガイド更新
MCPツール数 / MCP Tool Count
20 tools (unchanged from v0.1.1) / 20ツール(v0.1.1から変更なし)
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About TKMD/ReftrixMCP
Web design analysis MCP server with 26 tools for layout extraction, motion detection, quality scoring, and semantic search. Uses Playwright, pgvector HNSW, and Ollama Vision to turn web pages into searchable, structured design knowledge.
Related context
Beta — feedback welcome: [email protected]