MCAP
Offenes Log-Dateiformat mit Bibliotheken für Roboterdaten, Standard für ROS-2-Bags
Lizenz
MIT
Code: MIT, laut der LICENSE-Datei im Wurzelverzeichnis des GitHub-Repositorys. Pakete: Die C++-Bibliothek, die TypeScript-Pakete, die Python-Pakete und die Rust-Crates geben ebenfalls MIT an. Spezifikation: Formatspezifikation und Dokumentation liegen im selben Repository unter derselben Lizenz. Name und Logo: MCAP und sein Logo gehören Foxglove und werden von der Code-Lizenz nicht gewährt. Geprüft am 2026-11-10 anhand von LICENSE, cpp/mcap/LICENSE, den LICENSE-Dateien der TypeScript-Pakete, den setup.cfg-Dateien von Python und den Cargo.toml-Dateien von Rust.
Überblick
MCAP ist ein offenes Container-Dateiformat zum Aufzeichnen zeitgestempelter Publish-Subscribe-Daten aus mehreren Kanälen, also der Art von Log, die ein Roboter im Betrieb schreibt. Eine Datei kann Nachrichten in mehreren Serialisierungen zugleich enthalten, etwa ROS 1, ROS 2, Protobuf, FlatBuffers oder JSON, und sie trägt jedes Nachrichtenschema in sich, sodass sie sich ohne den ursprünglichen Code dekodieren lässt. Daten werden nur anhängend in Chunks geschrieben, die mit zstd oder LZ4 komprimiert werden können, und ein Index am Ende lässt Leser direkt zu einem Topic oder Zeitbereich springen, ohne die ganze Datei zu durchsuchen. Foxglove entwickelt MCAP offen unter der MIT-Lizenz, mit Bibliotheken in C++, Go, Python, Rust, Swift und TypeScript und einem Kommandozeilenwerkzeug zum Untersuchen, Filtern, Zusammenführen und Reparieren von Dateien. Seit dem Release ROS 2 Iron Irwini vom 23. Mai 2023 ist es das Standard-Speicherformat von rosbag2, dem Aufzeichnungswerkzeug von ROS 2. Im November 2026 stellte Foxglove ein gemeinsames Benchmark-Harness für seine Bibliotheken vor, zusammen mit den damit gemessenen Beschleunigungen beim Schreiben.
MCAP (ausgesprochen „em-cap“) ist ein Dateiformat und eine Sammlung von Bibliotheken zum Aufzeichnen von Roboterdaten, offen entwickelt von Foxglove, einem Unternehmen, das außerdem eine kommerzielle Datenplattform für die Robotik verkauft. Zuvor hing das Format, in dem ein Team aufzeichnete, von seinem Framework ab: ROS 1 hatte seine .bag-Dateien, die außerhalb von ROS schwer zu nutzen sind, ROS 2 schrieb SQLite-Datenbanken, die ihre eigenen Nachrichtendefinitionen nicht mitführten, und viele andere Teams bauten eigene Binärformate. Foxgloves Bewertung bestehender Formate fand keines, das gut zur Robotik passte, und MCAP wurde entworfen, um diese Lücke zu schließen. Spezifikation, Dokumentation und Quellcode sind öffentlich, und das Format hat einen eigenen registrierten Medientyp, application/vnd.mcap.
Eine MCAP-Datei ist eine Folge von Records. Nachrichten sind in Kanäle gruppiert, etwa ein Sensor-Topic, und jeder Kanal verweist auf ein Schema, das seine Nachrichten beschreibt. Wie Nachrichten serialisiert sind, ist dem Format gleich: Das Register bekannter Kodierungen umfasst Nachrichten aus ROS 1 und ROS 2, Protobuf, FlatBuffers, JSON Schema, CBOR und Cap'n Proto, und eine Datei kann sie mischen. Weil die Schemas in der Datei stehen, lässt sich eine Aufzeichnung noch Jahre später auf einem Rechner dekodieren, der die ursprünglichen Nachrichtenpakete nie hatte. Writer hängen nur an. Das hält die Aufzeichnung schnell und erlaubt, eine teilweise geschriebene Datei wiederherzustellen, wenn der Roboter den Strom verliert. Nachrichten lassen sich in Chunks gruppieren, die mit zstd oder LZ4 komprimiert werden, jeweils mit optionaler Prüfsumme, und ein optionaler Summary-Abschnitt am Ende indiziert Chunks, Kanäle, Metadaten und Anhänge. Mit diesem Index kann ein Leser ein Topic oder ein Zeitfenster abrufen, ohne den Rest der Datei zu lesen, auch über ein Netzwerk.
Bibliotheken gibt es für C++, Go, Python, Rust, Swift und TypeScript, alle gegen die Spezifikation getestet, doch die Support-Matrix zeigt, dass sie nicht alle dieselben Lesefunktionen bieten. Das Python-Paket bringt Hilfen für Daten aus ROS 1, ROS 2 und Protobuf mit. Das MCAP-Kommandozeilenwerkzeug, installiert mit Homebrew oder als Release-Binary heruntergeladen, zeigt Dateistatistiken, filtert, führt zusammen, sortiert, komprimiert und repariert Dateien und wandelt Aufzeichnungen im Format ROS 1 .bag und ROS 2 .db3 in MCAP um. 2026 hat Foxglove es von Go in Rust neu geschrieben, mit derselben Bedienung.
In ROS 2 zeichnet rosbag2 über Storage-Plugins auf, und sein MCAP-Plugin wurde mit dem Release Iron Irwini vom 23. Mai 2023 zum Standard, nach einem Pull Request, der SQLite als Standard ablöste. SQLite ist weiterhin als Option verfügbar. Viele Viewer und Werkzeuge für Roboterdaten öffnen MCAP-Dateien, darunter Foxgloves eigene App, Lichtblick, BAGEL, PlotJuggler und Rerun.
Am 9. November 2026 veröffentlichte Foxglove den Beitrag Measuring and improving MCAP performance über ein gemeinsames Benchmark-Harness, das mit Pull Request 1611 hinzukam. Es führt die Bibliotheken für C++, Rust, Go, Python und TypeScript mit byte-identischen Daten durch drei Szenarien: eine Million Nachrichten zu je 100 Byte auf einem Kanal in jedem Speichermodus (ohne Chunks, mit Chunks, zstd und LZ4); eine simulierte Roboteraufzeichnung von 10 Sekunden mit 5 Kanälen, von einem Inertialsensor mit 200 Hz bis zu Kamerabildern mit 512 KB, insgesamt etwa 102 MB; und Lesevorgänge dieser Aufzeichnung, gefiltert nach Topic, nach Zeitbereich oder nach beidem. Jeder Lauf prüft die geschriebenen Bytes und die Zahl der zurückgelesenen Nachrichten und erfasst Zeit, Dateigröße und Spitzenspeicher. Nach Foxgloves eigenen Messungen, auf einem AMD Ryzen AI MAX+ 395 mit fest eingestellten 3,0 GHz und beim Schreiben in ein RAM-basiertes Dateisystem, sind C++-Schreibvorgänge mit LZ4 im Test mit einer Million Nachrichten etwa 8-mal so schnell wie im Januar 2026, und die Schreibzeit von Rust in diesem Test ist auf weniger als die Hälfte gesunken. Ein Teil des Gewinns kommt von neuen Standardwerten statt von schnellerem Code: Go und C++ nutzen jetzt die schnellste LZ4-Einstellung, die Dateien um 15 % bis 30 % größer macht, während C++ bei zstd auf Stufe 3 wechselte, was etwa 31 % kleinere Dateien auf Kosten langsamerer Schreibvorgänge ergibt. Die veröffentlichten Ergebnisse betreffen nur das Schreiben, und Foxglove nennt die Python-Bibliothek bei kleinen Nachrichten deutlich langsamer als die anderen.
Warum es wichtig ist
Durch Aufzeichnungen suchen Robotikteams Fehler, untersuchen Vorfälle und sammeln Trainingsdaten, und ein Log nützt nur, wenn die Werkzeuge darum herum es lesen können. MCAP ist die Datei, die ROS 2 schreibt, wenn jemand auf einem aktuellen Release ros2 bag record ausführt, und das Format, das Viewer wie Lichtblick, PlotJuggler und Rerun annehmen, daher ist es für Roboter-Logs innerhalb und außerhalb von ROS weit verbreitet. Es ist offen unter MIT, hat eine schriftliche Spezifikation und einen registrierten Medientyp und trägt seine eigenen Schemas, sodass heute aufgezeichnete Daten auch später noch ohne den Code dekodiert werden können, der sie erzeugt hat. Foxglove, ein kommerzielles Unternehmen, betreut es, und das gemeinsame Benchmark-Harness im Repository gibt allen einen einheitlichen Weg, die Leistung der Bibliotheken auf eigener Hardware zu prüfen, statt sich auf Foxgloves Zahlen zu verlassen. Reruns rosbag2-Plugin für sein RRD-Format ist eine Alternative für Teams, die ihre Bags eher für Abfragen und Visualisierung als für Aufzeichnungsgeschwindigkeit speichern wollen.
Welches Problem es löst
Roboter-Logs mischen viele Datenströme mit unterschiedlichen Raten und Größen, und vor MCAP hing die Datei, in die ein Team aufzeichnete, von seinem Framework ab: Bags aus ROS 1, die außerhalb von ROS schwer lesbar sind, SQLite-Datenbanken aus ROS 2, die ihre eigenen Nachrichtendefinitionen nicht mitführten, oder eigene Formate, die jedes Werkzeug erst lernen musste. MCAP gibt ihnen einen offenen, selbstbeschreibenden Container, der schnell schreibt, unterbrochene Aufzeichnungen übersteht, jede Serialisierung in derselben Datei aufnimmt und sich über einen Index nach Topic und Zeit durchsuchen lässt, mit Bibliotheken in sechs Sprachen, damit Werkzeuge ihn lesen und schreiben können, ohne jeweils einen eigenen Parser zu bauen.
Wichtigste Punkte
- Ein offenes Container-Dateiformat für zeitgestempelte Publish-Subscribe-Daten wie Roboter-Logs, mit öffentlicher Spezifikation und dem Medientyp application/vnd.mcap
- Unabhängig von der Serialisierung: ROS 1, ROS 2, Protobuf, FlatBuffers, JSON und mehr in einer Datei, jedes Schema darin gespeichert
- Schreiben nur durch Anhängen, Wiederherstellung unterbrochener Dateien, Chunk-Kompression mit zstd oder LZ4 und ein Index zum Lesen nach Topic oder Zeitbereich
- Bibliotheken in C++, Go, Python, Rust, Swift und TypeScript sowie ein Kommandozeilenwerkzeug, inzwischen in Rust geschrieben
- Standard-Speicherformat von rosbag2 seit ROS 2 Iron Irwini, veröffentlicht am 23. Mai 2023
- Ein gemeinsames Benchmark-Harness für fünf der Bibliotheken, mit Foxgloves eigenen Schreibergebnissen vom 9. November 2026
- MIT-Lizenz, offen entwickelt von Foxglove
Für wen
- Entwickler mit ROS 2, die Bags aufzeichnen, abspielen und konvertieren
- Robotikteams außerhalb von ROS, die ein Log-Format für gemischte Daten aus Protobuf, JSON oder FlatBuffers brauchen
- Entwickler von Datenwerkzeugen, Viewern und Pipelines, die Roboter-Logs lesen und schreiben müssen
- Teams, die Roboterdaten für maschinelles Lernen sammeln und selbstbeschreibende, indizierte Aufzeichnungen wollen
Einschränkungen
- Foxglove, ein kommerzielles Unternehmen, betreut das Format und die meisten Bibliotheken, und seine eigene Datenplattform für die Robotik ist ein kommerzielles Produkt
- Die Bibliotheken bieten nicht alle dieselben Funktionen: Die Support-Matrix nennt zum Beispiel kein zeitlich geordnetes Lesen in Rust und kein indiziertes ungeordnetes Lesen in Swift
- Die Leistungszahlen im Beitrag vom November 2026 stammen von Foxglove selbst, gemessen auf einem Rechner mit AMD Ryzen AI MAX+ 395, der in ein RAM-basiertes Dateisystem schrieb
- Diese Ergebnisse betreffen nur das Schreiben; die Lesegeschwindigkeit ist nicht Teil des veröffentlichten Vergleichs
- Die Python-Bibliothek ist bei kleinen Nachrichten nach Foxgloves eigener Aussage deutlich langsamer als die anderen
- Standardwerte der Writer wie Kompression und Chunking unterscheiden sich noch zwischen den Sprachen, sodass dieselben Daten unterschiedliche Dateigrößen und Geschwindigkeiten ergeben können
- Der Index liegt im Summary-Abschnitt am Ende der Datei, daher hat eine vor dem Schließen abgebrochene Aufzeichnung keinen Index, bis sie mit der CLI wiederhergestellt wird