Crypto Market Sentinel

Hermes Agent용 읽기 전용 시장 이상 감지 MCP 서버입니다. BTC, ETH, RENDER를 모니터링하고 변동성 인식 P0/P1/P2 임계값을 적용하며, Hermes가 Feishu를 통해 전달할 공유 pif.event.v1 계약을 발행합니다.

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

Why / 设计理念

• 가격이 단순히 변할 때가 아니라, 시장의 행동이 바뀔 때만 알림을 보냅니다.

• P0는 즉시 전달되고, P1은 다이제스트로 들어가며, P2는 감사 전용입니다.

• 반복 알림은 45분 동안 억제되며, 이벤트가 임계값의 1.5배로 확대되는 경우는 예외입니다.

• 트리거된 규칙은 임계값의 80% 미만으로 떨어져야 재무장할 수 있습니다.

• 15초보다 오래된 데이터는 새 알림을 일시 중지합니다.

• 계정, 주문, 출금, 서명 또는 API Secret 표면이 존재하지 않습니다.

로컬 실행

npm ci
npm test
npm run demo

API 키가 필요 없는 일회성 공개 Binance 스냅샷(선택 사항):

node src/cli.js --live BTC

현재 네트워크에서 Binance를 사용할 수 없으면 명령이 안전하게 종료됩니다. 결정적 데모 및 MCP 도구는 계속 사용할 수 있습니다.

macOS에서 Hermes에 추가

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입니다. 둘 다 동일한 긴급/다이제스트/감사 이벤트 봉투를 사용합니다.

Hermes macOS 설정 및 공유 PIF 이벤트 계약을 참조하세요.

라이선스

MIT. LICENSE를 참조하세요.