Crypto Market Sentinel

面向 Hermes Agent 的只读市场异常 MCP 服务器。它监控 BTC、ETH 和 RENDER，应用感知波动率的 P0/P1/P2 阈值，并发出共享的 pif.event.v1 契约，供 Hermes 通过 Feishu 投递。

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

Why / 设计理念

• 仅在市场行为发生变化时发出告警，而非价格单纯变动时。

• P0 立即触发；P1 进入摘要；P2 仅用于审计。

• 重复事件在 45 分钟内被抑制，除非事件升级至阈值的 1.5 倍。

• 已触发的规则必须回落到其阈值的 80% 以下才能重新布防。

• 超过 15 秒的数据将暂停新告警。

• 不存在账户、订单、提现、签名或 API Secret 等表面。

本地运行

npm ci
npm test
npm run demo

可选的单次公开 Binance 快照（无需 API key）：

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。