Crypto Market Sentinel

Ein schreibgeschützter Marktanomalie-MCP-Server für Hermes Agent. Er beobachtet BTC, ETH und RENDER, wendet volatilitätsbewusste P0/P1/P2-Schwellenwerte an und sendet den gemeinsamen pif.event.v1-Vertrag, damit Hermes ihn über Feishu zustellt.

只看公开行情、不接账户、不交易。冷却、迟滞与断线 fail-closed 都在确定性状态机中执行，而不是交给模型猜。

Warum / 设计理念

• Nur warnen, wenn sich das Marktverhalten ändert, nicht wenn sich nur ein Preis ändert.

• P0 ist sofort; P1 geht in einen Digest ein; P2 ist nur für Audits.

• Wiederholungen werden 45 Minuten lang unterdrückt, es sei denn, das Ereignis eskaliert auf das 1,5-fache des Schwellenwerts.

• Eine ausgelöste Regel muss unter 80 % ihres Schwellenwerts fallen, bevor sie wieder scharfgeschaltet werden kann.

• Daten, die älter als 15 Sekunden sind, pausieren neue Warnungen.

• Es gibt keine Konten, Aufträge, Abhebungen, Signaturen oder API-Secrets.

Lokale Ausführung

npm ci
npm test
npm run demo

Optionale einmalige öffentliche Binance-Momentaufnahme (ohne API-Schlüssel):

node src/cli.js --live BTC

Wenn Binance im aktuellen Netzwerk nicht verfügbar ist, beendet sich der Befehl sicher; deterministische Demo- und MCP-Tools bleiben verfügbar.

Hinzufügen zu Hermes unter macOS

git clone https://github.com/roclee2692/crypto-market-sentinel.git ~/Projects/crypto-market-sentinel
cd ~/Projects/crypto-market-sentinel && npm ci
hermes mcp add market-sentinel --command node --args "$HOME/Projects/crypto-market-sentinel/src/mcp.js"
hermes mcp test market-sentinel

Hermes stellt Namen wie mcp_market_sentinel_evaluate_market_snapshot bereit. Der MCP gibt eine Feishu-fertige Nachricht zurück; Hermes verwendet weiterhin den bereits konfigurierten Feishu-Kanal.

Werkzeuge

• evaluate_market_snapshot

• simulate_market_scenario

• get_market_policy

Das begleitende Repository ist email-triage-agent. Beide verwenden dieselbe Ereignishülle für dringend/Digest/Audit.

Siehe Hermes macOS Setup und den gemeinsamen PIF-Ereignisvertrag.

Lizenz

MIT. Siehe LICENSE.