Open Source Robotics

Una colección curada de proyectos, herramientas y software de robótica de código abierto de alta calidad.

MCAP

Formato de archivo abierto y bibliotecas para registros de robots, estándar en ROS 2

Licencia

MIT

Código: MIT, según el archivo LICENSE en la raíz del repositorio de GitHub. Paquetes: la biblioteca de C++, los paquetes de TypeScript, los paquetes de Python y los crates de Rust declaran también MIT. Especificación: la especificación del formato y la documentación están en el mismo repositorio, con la misma licencia. Nombre y logotipo: MCAP y su logotipo pertenecen a Foxglove y la licencia del código no los concede. Comprobado el 2026-11-10 con LICENSE, cpp/mcap/LICENSE, los archivos LICENSE de los paquetes de TypeScript, los archivos setup.cfg de Python y los archivos Cargo.toml de Rust.

Resumen

MCAP es un formato de archivo contenedor abierto para grabar datos de publicación-suscripción con marca de tiempo y varios canales, el tipo de registro que escribe un robot mientras funciona. Un archivo puede contener mensajes en varias serializaciones a la vez, como ROS 1, ROS 2, Protobuf, FlatBuffers o JSON, y lleva dentro el esquema de cada mensaje, de modo que se puede decodificar sin el código original. Los datos se escriben solo añadiendo, en bloques que pueden comprimirse con zstd o LZ4, y un índice al final permite a los lectores saltar a un tema o a un intervalo de tiempo sin recorrer todo el archivo. Foxglove desarrolla MCAP de forma abierta con licencia MIT, con bibliotecas en C++, Go, Python, Rust, Swift y TypeScript y una herramienta de línea de comandos para inspeccionar, filtrar, fusionar y reparar archivos. Desde la versión ROS 2 Iron Irwini, del 23 de mayo de 2023, es el formato de almacenamiento por defecto de rosbag2, la herramienta de grabación de ROS 2. En noviembre de 2026 Foxglove presentó un banco de pruebas compartido para sus bibliotecas y las mejoras de velocidad de escritura que midió con él.

MCAP (se pronuncia «em-cap») es un formato de archivo y un conjunto de bibliotecas para registrar datos de robots, desarrollado de forma abierta por Foxglove, una empresa que además vende una plataforma comercial de datos para robótica. Antes, el formato en el que grababa un equipo dependía de su framework: ROS 1 tenía sus archivos .bag, difíciles de usar fuera de ROS; ROS 2 escribía bases de datos SQLite que no llevaban sus propias definiciones de mensajes, y muchos otros equipos creaban formatos binarios propios. La evaluación de formatos existentes de Foxglove no encontró ninguno que encajara bien con la robótica, y MCAP se diseñó para cubrir ese hueco. Su especificación, su documentación y su código fuente son públicos, y el formato tiene su propio tipo de medio registrado, application/vnd.mcap.

Un archivo MCAP es una secuencia de registros. Los mensajes se agrupan en canales, por ejemplo un tema de un sensor, y cada canal apunta a un esquema que describe sus mensajes. Al formato no le importa cómo se serializan los mensajes: el registro de codificaciones conocidas incluye mensajes de ROS 1 y ROS 2, Protobuf, FlatBuffers, JSON Schema, CBOR y Cap'n Proto, y un mismo archivo puede mezclarlos. Como los esquemas se guardan en el archivo, una grabación puede decodificarse años después en una máquina que nunca tuvo los paquetes de mensajes originales. Los escritores solo añaden datos, lo que mantiene rápida la grabación y permite recuperar un archivo escrito a medias si el robot se queda sin energía. Los mensajes pueden agruparse en bloques comprimidos con zstd o LZ4, cada uno con una suma de verificación opcional, y una sección de resumen opcional al final indexa bloques, canales, metadatos y adjuntos. Ese índice permite a un lector obtener un tema o una ventana de tiempo sin leer el resto del archivo, también a través de una red.

Hay bibliotecas para C++, Go, Python, Rust, Swift y TypeScript, todas probadas frente a la especificación, aunque la matriz de compatibilidad muestra que no todas ofrecen las mismas funciones de lectura. El paquete de Python añade utilidades para datos de ROS 1, ROS 2 y Protobuf. La herramienta de línea de comandos de MCAP, que se instala con Homebrew o se descarga como binario de una versión, muestra estadísticas de archivos, filtra, fusiona, ordena, comprime y recupera archivos, y convierte grabaciones ROS 1 .bag y ROS 2 .db3 a MCAP. En 2026 Foxglove la reescribió de Go a Rust con la misma interfaz.

En ROS 2, rosbag2 graba mediante plugins de almacenamiento, y su plugin de MCAP pasó a ser el predeterminado con la versión Iron Irwini del 23 de mayo de 2023, tras un pull request que sustituyó a SQLite como opción por defecto. SQLite sigue disponible como opción. Muchos visores y herramientas para datos de robots abren archivos MCAP, entre ellos la propia aplicación de Foxglove, Lichtblick, BAGEL, PlotJuggler y Rerun.

El 9 de noviembre de 2026 Foxglove publicó Measuring and improving MCAP performance, sobre un banco de pruebas compartido que se añadió en el pull request 1611. Hace pasar las bibliotecas de C++, Rust, Go, Python y TypeScript por tres escenarios con datos idénticos byte a byte: un millón de mensajes de 100 bytes en un solo canal en cada modo de almacenamiento (sin bloques, con bloques, zstd y LZ4); una grabación simulada de un robot de 10 segundos con 5 canales, desde un sensor inercial a 200 Hz hasta fotogramas de cámara de 512 KB, unos 102 MB en total; y lecturas de esa grabación filtradas por tema, por intervalo de tiempo o por ambos. Cada ejecución comprueba los bytes escritos y el número de mensajes leídos de vuelta, y registra el tiempo, el tamaño del archivo y la memoria máxima. Según las mediciones de la propia Foxglove, en un AMD Ryzen AI MAX+ 395 fijado a 3,0 GHz y escribiendo en un sistema de archivos en RAM, las escrituras LZ4 de C++ en la prueba del millón de mensajes son unas 8 veces más rápidas que en enero de 2026, y el tiempo de escritura de Rust en esa prueba es menos de la mitad del que era. Parte de la mejora viene de nuevos valores por defecto y no de un código más rápido: Go y C++ usan ahora el ajuste LZ4 más rápido, que hace los archivos entre un 15 % y un 30 % más grandes, mientras que C++ pasó al nivel 3 en zstd, con archivos alrededor de un 31 % más pequeños a costa de escrituras más lentas. Los resultados publicados cubren solo la escritura, y Foxglove señala que la biblioteca de Python es mucho más lenta que las demás con mensajes pequeños.

Por qué importa

Grabar es como los equipos de robótica depuran, investigan incidentes y reúnen datos de entrenamiento, y un registro solo sirve si las herramientas que lo rodean pueden leerlo. MCAP es el archivo que escribe ROS 2 cuando alguien ejecuta ros2 bag record en una versión actual, y el formato que aceptan visores como Lichtblick, PlotJuggler y Rerun, por lo que se usa mucho para registros de robots, dentro y fuera de ROS. Es abierto bajo MIT, tiene una especificación escrita y un tipo de medio registrado, y lleva sus propios esquemas, de modo que los datos grabados hoy se podrán decodificar más adelante sin el código que los produjo. Foxglove, una empresa comercial, lo mantiene, y el banco de pruebas compartido del repositorio da a cualquiera una forma común de comprobar el rendimiento de sus bibliotecas en su propio hardware en lugar de fiarse de las cifras de Foxglove. El plugin de rosbag2 para el formato RRD de Rerun es una alternativa para los equipos que quieren guardar sus bags pensando en consultas y visualización más que en velocidad de grabación.

Qué problema resuelve

Los registros de robots mezclan muchos flujos de datos con frecuencias y tamaños distintos, y antes de MCAP el archivo en el que grababa un equipo dependía de su framework: bags de ROS 1 difíciles de leer fuera de ROS, bases de datos SQLite de ROS 2 que no llevaban sus propias definiciones de mensajes o formatos internos que cada herramienta tenía que aprender. MCAP les da un contenedor abierto y autodescriptivo que escribe rápido, sobrevive a grabaciones interrumpidas, admite cualquier serialización en el mismo archivo y se puede consultar por tema y tiempo mediante un índice, con bibliotecas en seis lenguajes para que las herramientas lo lean y escriban sin construir cada una su propio analizador.

Puntos clave

  • Un formato de archivo contenedor abierto para datos de publicación-suscripción con marca de tiempo, como los registros de robots, con especificación pública y el tipo de medio application/vnd.mcap
  • Independiente de la serialización: ROS 1, ROS 2, Protobuf, FlatBuffers, JSON y más en un solo archivo, con cada esquema guardado dentro
  • Escritura solo por adición, recuperación de archivos interrumpidos, compresión por bloques con zstd o LZ4 y un índice para leer por tema o intervalo de tiempo
  • Bibliotecas en C++, Go, Python, Rust, Swift y TypeScript, además de una herramienta de línea de comandos escrita ahora en Rust
  • Formato de almacenamiento por defecto de rosbag2 desde ROS 2 Iron Irwini, publicado el 23 de mayo de 2023
  • Un banco de pruebas compartido para cinco de las bibliotecas, con resultados de escritura propios de Foxglove publicados el 9 de noviembre de 2026
  • Licencia MIT, desarrollado de forma abierta por Foxglove

Para quién es

  • Desarrolladores de ROS 2 que graban, reproducen y convierten bags
  • Equipos de robótica fuera de ROS que necesitan un único formato de registro para datos mixtos de Protobuf, JSON o FlatBuffers
  • Desarrolladores de herramientas de datos, visores y pipelines que necesitan leer y escribir registros de robots
  • Equipos que reúnen datos de robots para aprendizaje automático y quieren grabaciones autodescriptivas e indexadas

Limitaciones

  • Foxglove, una empresa comercial, mantiene el formato y la mayoría de las bibliotecas, y su propia plataforma de datos para robótica es un producto comercial
  • No todas las bibliotecas ofrecen las mismas funciones: la matriz de compatibilidad indica, por ejemplo, que Rust no tiene lectura ordenada por marca de tiempo y Swift no tiene lectura indexada sin orden
  • Las cifras de rendimiento de la publicación de noviembre de 2026 son de la propia Foxglove, medidas en una máquina con AMD Ryzen AI MAX+ 395 que escribía en un sistema de archivos en RAM
  • Esos resultados cubren solo la escritura; la velocidad de lectura no forma parte de la comparación publicada
  • La biblioteca de Python es mucho más lenta que las demás con mensajes pequeños, según la propia Foxglove
  • Los valores por defecto de los escritores, como la compresión y la división en bloques, aún difieren entre lenguajes, así que los mismos datos pueden dar tamaños de archivo y velocidades distintos
  • El índice está en la sección de resumen al final del archivo, así que una grabación cortada antes de cerrarse no tiene índice hasta que se recupera con la CLI

Este sitio web requiere JavaScript. Por favor, habilite JavaScript para explorar nuestros proyectos de robótica.