Crypto Market Sentinel

Un servidor MCP de anomalías de mercado de solo lectura para Hermes Agent. Observa BTC, ETH y RENDER, aplica umbrales P0/P1/P2 sensibles a la volatilidad y emite el contrato compartido pif.event.v1 para que Hermes lo entregue a través de Feishu.

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

Por qué / 设计理念

• Alerta solo cuando el mercado cambia de comportamiento, no cuando un precio simplemente cambia.

• P0 es inmediato; P1 entra en un resumen; P2 es solo de auditoría.

• Las repeticiones se suprimen durante 45 minutos, a menos que el evento escale a 1,5× el umbral.

• Una regla activada debe caer por debajo del 80% de su umbral antes de poder rearmarse.

• Los datos con más de 15 segundos pausan nuevas alertas.

• No existe superficie de cuenta, orden, retiro, firma o secreto de API.

Ejecución local

npm ci
npm test
npm run demo

Instantánea pública opcional de Binance de una sola vez (sin clave de API):

node src/cli.js --live BTC

Si Binance no está disponible en la red actual, el comando sale de forma segura; la demo determinista y las herramientas MCP siguen disponibles.

Añadir a Hermes en 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 expone nombres como mcp_market_sentinel_evaluate_market_snapshot. El MCP devuelve un mensaje listo para Feishu; Hermes sigue usando el canal de Feishu que ya configuraste.

Herramientas

• evaluate_market_snapshot

• simulate_market_scenario

• get_market_policy

El repositorio complementario es email-triage-agent. Ambos usan el mismo sobre de eventos urgente/resumen/auditoría.

Consulta la configuración de Hermes en macOS y el contrato de eventos PIF compartido.

Licencia

MIT. Consulta LICENSE.