# Cerbero_mcp

Server MCP riusabili (exchange + market data) per la suite Cerbero.
Spinta da `Cerbero/` (commit `pre-split-2026-04-27`) come parte dello
split documentato in `docs/superpowers/specs/2026-04-27-split-mcp-core-design.md`
(nel repo storico).

## Servizi
- `mcp-alpaca`, `mcp-bybit`, `mcp-deribit`, `mcp-hyperliquid` — exchange
  con `place_order`, `environment_info`, leverage cap server-side
- `mcp-macro`, `mcp-sentiment` — read-only market data

## Avvio locale

```bash
docker compose up -d
bash tests/smoke/run.sh
```

## Configurazione

Vedi `secrets/*.json` e variabili `*_TESTNET` / `ALPACA_PAPER` in
`docker-compose.yml` per override ambiente.

### Risoluzione environment (testnet/mainnet)

Ogni servizio exchange usa `mcp_common.environment.resolve_environment()`
che applica la precedenza:

1. env var di override (`DERIBIT_TESTNET`, `BYBIT_TESTNET`,
   `HYPERLIQUID_TESTNET`, `ALPACA_PAPER`)
2. flag nel secret JSON (`testnet` o `paper` per alpaca)
3. default `testnet`

Gli URL canonici live/testnet sono passati come kwargs
`default_base_url_live` / `default_base_url_testnet` direttamente al
resolver — non serve duplicarli nel secret JSON, ma se presenti
prevalgono sui default del codice.