mcp-drift-monitordetecta cambios no autorizados en servidores MCP (Model Context Protocol). Implementa el control primario faltante descrito en[arXiv:2608.00997]: un barrido completo periódico del catálogo que re-descarga todos los servidores y recomputa hashes.
arXiv:2608.00997 (MCP Registry Drift: A 88.6-Day Measurement of 19,099 Servers) reporta un punto ciego crítico: los enfoques tradicionales de detección de cambios fallan en identificar dos modos de fallo:
El paper mide 15,845 eventos de cambio, 19,877 adiciones y 911 eliminaciones, pero los modelos que rankean por historial previo pierden una fracción significativa de estos eventos.
Este monitor cierra esa brecha con el control primario que el paper propone pero no implementa: un full-catalog sweep periódico.
mcp-drift-monitor
implementa un motor de diferencias único (compute_events
) que sirve tanto para polling incremental como para barridos completos. No hay lógica duplicada.
Cada vez que un hash de descripción cambia, el motor revalida el contenido (len(drifts) > 0
es el único disparador). Si el registro responde 429, aplica backoff con Retry-After
. Si el payload está malformado, lanza SchemaDriftError
y registra el payload ofensor a nivel ERROR.
core/
diff.py — CatalogEntry, DriftEvent, NewArrivalEvent, RemovalEvent, compute_events
hasher.py — normalize_description (NFC), hash_description
state.py — StateStore (sqlite), FetchStatus, removed flag, get_all_hashes
poller.py — Poller.fetch_catalog, PollConfig, SchemaDriftError, backoff
sweep.py — run_sweep (control primario), SweepReport
calibrate.py — replay (FR-6), ReplayReport, external validity vs panel
El monitor se calibró y verificó contra el panel real del paper (19,099 servidores observados durante 88.6 días). Resultados:
| Evento del panel | Recuento | compute_events (neto) |
|---|---|---|
add |
||
| 19,877 | 16,367 + 3,510 seed = 19,877 | |
chg |
||
| 15,845 | 2,514 drift netos (<= chg) | |
del |
||
| 911 | 911 eliminaciones |
arrival_events == add_count
y removal_events == del_count
se cumplen porque ningún servidor es eliminado y re-agregado dentro del mismo intervalo inter-snapshot (0 violaciones de precondición).
Más detalles de la metodología de calibración en el README del repositorio.
docker run -v mcp-data:/app/data --name drift-monitor-prod -d \
amurlaniakea/mcp-drift-monitor:latest sweep
git clone https://github.com/amurlaniakea/mcp-drift-monitor.git
cd mcp-drift-monitor
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
ruff check mcp_drift_monitor tests && pytest -v
Suit de tests:
tests/test_diff.py
— motor de diferencias (determinismo, orden, disjunción de eventos)tests/test_hasher.py
— normalización NFC + casos límite de hashingtests/test_poller.py
— backoff 429, agotamiento de reintentos, registro de desviaciones de esquematests/test_state.py
— persistencia de StateStore, flag eliminado, dataclass fuente únicatests/test_sweep.py
— control primario de barrido completo (nueva adición, cambio silencioso)tests/test_replay_panel.py
— [EXTERNAL-VALIDITY] AC-1/2/3 contra el panel real del paperEl repositorio incluye GitHub Actions que ejecutan ruff + pytest en cada PR, y construyen imágenes multi-platforma (amd64/arm64) a GHCR y DockerHub en cada release.
AGPL-3.0-or-later. SPDX-FileCopyrightText: 2026 Pedro Sordo Martínez.
amurlaniakea/mcp-drift-monitor
Licencia: AGPL-3.0-or-later