Crypto Market Sentinel

Сервер MCP для аномалий рынка, доступный только для чтения, для Hermes Agent. Он отслеживает BTC, ETH и RENDER, применяет пороги P0/P1/P2 с учётом волатильности и отправляет общий контракт pif.event.v1 для доставки Hermes через Feishu.

Только публичные рыночные данные, без подключения к аккаунтам, без торговли. Охлаждение, задержки и отключение fail-closed выполняются в детерминированном конечном автомате, а не предоставляются на усмотрение модели.

Почему / Дизайн-философия

• Срабатывание только при изменении поведения рынка, а не просто при изменении цены.

• P0 — немедленно; P1 попадает в дайджест; P2 — только для аудита.

• Повторные срабатывания подавляются в течение 45 минут, если только событие не превышает порог в 1,5 раза.

• Сработавшее правило должно опуститься ниже 80% своего порога, прежде чем оно сможет перевооружиться.

• Данные старше 15 секунд приостанавливают новые оповещения.

• Не существует ни аккаунта, ни ордеров, ни вывода средств, ни подписей, ни поверхности API Secret.

Локальный запуск

npm ci
npm test
npm run demo

Необязательный одноразовый публичный снимок Binance (без ключа API):

node src/cli.js --live BTC

Если Binance недоступен в текущей сети, команда безопасно завершается; детерминированное демо и инструменты MCP остаются доступными.

Добавление в Hermes на 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 предоставляет имена, такие как mcp_market_sentinel_evaluate_market_snapshot. MCP возвращает сообщение, готовое для Feishu; Hermes продолжает использовать уже настроенный вами канал Feishu.

Инструменты

• evaluate_market_snapshot

• simulate_market_scenario

• get_market_policy

Сопутствующий репозиторий — email-triage-agent. Оба используют одинаковую оболочку событий urgent/digest/audit.

См. настройку Hermes для macOS и общий контракт событий PIF.

Лицензия

MIT. См. LICENSE.