mcp-drift-monitor detecta 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.
Problema 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: Cambios silenciosos — un servidor cuyo hash de descripción cambia, pero el monitor ya lo conocía y lo rankinga por historial pasado.
Nuevas adiciones — servidores que aparecen en el registro sin que el monitor tenga registro previo.
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.
Solución implementa un motor de diferencias único () 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 ( es el único disparador).
Si el registro responde 429, aplica backoff con .
Si el payload está malformado, lanza y registra el payload ofensor a nivel ERROR.
Arquitectura Resultados de calibración 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) 19,877 16,367 + 3,510 seed = 19,877 15,845 2,514 drift netos (<= chg) 911 911 eliminaciones y 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.
Cómo usarlo Con Docker Como librería Tests Suit de tests: — motor de diferencias (determinismo, orden, disjunción de eventos) — normalización NFC + casos límite de hashing — backoff 429, agotamiento de reintentos, registro de desviaciones de esquema — persistencia de StateStore, flag eliminado, dataclass fuente única — control primario de barrido completo (nueva adición, cambio silencioso) — [EXTERNAL-VALIDITY] AC-1/2/3 contra el panel real del paper CI/CD El 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.
Licencia AGPL-3.0-or-later.
SPDX-FileCopyrightText: 2026 Pedro Sordo Martínez.
Links Paper: arXiv:2608.00997 Repo: github.com/amurlaniakea/mcp-drift-monitor Docker Hub: Licencia: AGPL-3.0-or-later