HeLa MCP Ecosystem
v1.0.0 (c2cdf68)
Health & Reliability

Diagnostics & Troubleshooting

Comprehensive automated diagnostic suite and guided playbooks for resolving common environment, runtime, database, and client communication issues.

Diagnostic Tool

Running Doctor Diagnostics

Blotcat Doctor Health Diagnostics
Automated Doctor Health Diagnostics · 10-Server Stdio Handshake Check ./setup.sh doctor

The fastest way to diagnose your ecosystem is running the built-in diagnostic tool:

./setup.sh doctor

Doctor automatically audits 5 core subsystems:

1. Host Prerequisites

Checks Node.js (>=18.0.0), npm, Git, SQLite3 CLI, and optional Python 3.

2. Server Builds & Entries

Verifies dist/index.js or build/index.js artifacts across all 10 repositories.

3. Stdio Smoke Tests

Performs non-blocking stdio JSON-RPC handshake with each server (<300ms timeout).

4. External Runtimes & Fallbacks

Audits Playwright/Chromium, ADB, and Blender with graceful offline warnings.

Playbooks

Common Scenarios & Instant Fixes

1. Playwright / Chromium Missing (HeLa Cytosol)

Occurs on fresh systems or minimal cloud servers when browser binaries haven't been installed.

npx playwright install --with-deps chromium

2. SQLite Database Lock / Recovery (HeLa Genome)

If an abnormal termination locks SQLite memory.db, force WAL mode and integrity verification:

sqlite3 memory.db "PRAGMA journal_mode=WAL; PRAGMA integrity_check;"

3. Deterministic Snapshot Rollback

If an upstream repository introduces a breaking change in dev mode, pin immediately to the certified release snapshot:

./setup.sh --snapshot v1.0.0 --reconfigure

4. Android ADB Offline or Unauthorized (HeLa Receptor)

If physical device is not recognized by ADB daemon, restart ADB and accept the RSA host prompt on device:

adb kill-server && adb start-server && adb devices
🔍 ESC