Skip to content

TKMD/ReftrixMCP

v0.1.2 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

Published 3mo MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

accessibility claude core-web-vitals design-analysis gdpr layout-analysis
+14 more
mcp mcp-server motion-detection ollama onnx-runtime pgvector playwright reftrix responsive-design semantic-search typescript vector-db wcag web-design

Summary

AI summary

Prevents 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検出
    • GpuVendor enum (NVIDIA | APPLE_METAL | UNKNOWN) for GPU vendor identification / GPUベンダー識別用の列挙型
    • HardwareDetector.isAppleSilicon() static method (process.platform + process.arch, no external commands) / 外部コマンド不使用の静的メソッド
    • Ollama /api/ps reports Unified Memory as size_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_file two-stage loading (.env.example defaults → .env.local overrides) / env_file 2段階読み込み
    • Auth pre-flight check (pg_isready + psql SELECT 1) in db-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_ENV and OLLAMA_BASE_URL to MCP config example / MCP設定例に環境変数追加
  • 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対策済み
  • 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

Track TKMD/ReftrixMCP

Get notified when new releases ship.

Sign up free

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.

All releases →

Beta — feedback welcome: [email protected]