Open Source Robotics

高品質なオープンソースロボティクスプロジェクト、ツール、ソフトウェアの厳選コレクション。

MCAP

ロボットのログ向けのオープンなファイル形式とライブラリ、ROS 2 の bag の標準形式

ライセンス

MIT

コード:MIT。GitHub リポジトリのルートにある LICENSE ファイルによる。パッケージ:C++ ライブラリ、TypeScript パッケージ、Python パッケージ、Rust のクレートもそれぞれ MIT を表明している。仕様:形式仕様とドキュメントは同じリポジトリにあり、同じライセンスが適用される。名称とロゴ:MCAP とそのロゴは Foxglove に帰属し、コードのライセンスでは許諾されない。2026-11-10 に LICENSE、cpp/mcap/LICENSE、TypeScript パッケージの LICENSE ファイル、Python の setup.cfg ファイル、Rust の Cargo.toml ファイルで確認。

概要

MCAP は、タイムスタンプ付きで複数チャンネルのパブリッシュ/サブスクライブデータを記録するためのオープンなコンテナファイル形式で、ロボットが動作中に書き出すログを想定しています。一つのファイルに ROS 1、ROS 2、Protobuf、FlatBuffers、JSON など複数のシリアライズ方式のメッセージを同時に収められ、各メッセージのスキーマもファイル内に保持するため、元のコードがなくてもデコードできます。データは追記のみでチャンクごとに書き込まれ、チャンクは zstd または LZ4 で圧縮できます。末尾のインデックスにより、読み手はファイル全体を走査せずに特定のトピックや時間範囲へ直接移動できます。Foxglove が MIT ライセンスのもとオープンに開発しており、C++、Go、Python、Rust、Swift、TypeScript のライブラリと、ファイルの調査、フィルタ、結合、修復を行うコマンドラインツールがあります。2023年5月23日リリースの ROS 2 Iron Irwini 以降、ROS 2 の記録ツールである rosbag2 の標準のストレージ形式です。2026年11月、Foxglove はライブラリ共通のベンチマーク環境と、それを使って測定した書き込みの高速化を紹介しました。

MCAP(読みは「エムキャップ」)は、ロボットのデータを記録するためのファイル形式とライブラリ群で、Foxglove がオープンに開発しています。同社は商用のロボティクス向けデータプラットフォームも販売しています。MCAP 以前は、チームが記録に使う形式はフレームワーク次第でした。ROS 1 には .bag ファイルがありましたが ROS の外では扱いにくく、ROS 2 は自身のメッセージ定義を含まない SQLite データベースに書き込み、ほかの多くのチームは独自のバイナリ形式を作っていました。Foxglove による既存形式の評価ではロボティクスに合うものが見つからず、MCAP はその空白を埋めるために設計されました。仕様、ドキュメント、ソースコードはすべて公開されており、形式には登録済みのメディアタイプ application/vnd.mcap があります。

MCAP ファイルはレコードの並びです。メッセージはセンサーのトピックなどのチャンネルにまとめられ、各チャンネルはそのメッセージを記述するスキーマを参照します。形式はメッセージのシリアライズ方式を問いません。既知のエンコーディングのレジストリには ROS 1 と ROS 2 のメッセージ、Protobuf、FlatBuffers、JSON Schema、CBOR、Cap'n Proto が含まれ、一つのファイルで混在させられます。スキーマがファイル内に保存されるため、元のメッセージパッケージを一度も入れたことのないマシンでも、何年も後に記録をデコードできます。書き込みは追記だけなので記録が速く、ロボットの電源が落ちても書きかけのファイルを復旧できます。メッセージは zstd または LZ4 で圧縮したチャンクにまとめられ、それぞれに任意でチェックサムを付けられます。末尾の任意のサマリーセクションが、チャンク、チャンネル、メタデータ、添付ファイルを索引付けします。このインデックスにより、読み手はファイルの残りを読まずに 一つのトピックや 一つの時間範囲を取り出せ、ネットワーク越しでも同じです。

ライブラリは C++、Go、Python、Rust、Swift、TypeScript 向けにあり、すべて仕様に対してテストされていますが、サポート表を見ると読み込み機能はライブラリごとに異なります。Python パッケージには ROS 1、ROS 2、Protobuf のデータ用の補助機能が付いています。MCAP コマンドラインツールは Homebrew でインストールするかリリースのバイナリをダウンロードして使い、ファイルの統計表示、フィルタ、結合、並べ替え、圧縮、復旧を行い、ROS 1 .bag と ROS 2 .db3 の記録を MCAP に変換します。2026 年に Foxglove はこれを Go から Rust で書き直し、使い方は変えていません。

ROS 2 では rosbag2 がストレージプラグインを通じて記録し、その MCAP プラグインは2023年5月23日の Iron Irwini リリースで標準になりました。標準を SQLite から切り替えたプルリクエストを受けたものです。SQLite も引き続き選択できます。ロボットデータ向けの多くのビューアやツールが MCAP ファイルを開けます。Foxglove 自身のアプリのほか、Lichtblick、BAGEL、PlotJuggler、Rerun などです。

2026年11月9日、Foxglove は Measuring and improving MCAP performance を公開し、プルリクエスト 1611 で追加された共通のベンチマーク環境を紹介しました。この環境は C++、Rust、Go、Python、TypeScript のライブラリに、バイト単位で同一のデータで 三つのシナリオを実行させます。各ストレージモード(チャンクなし、チャンクあり、zstd、LZ4)で 一つのチャンネルに 100 バイトのメッセージを百万件書くもの、200 Hz の慣性センサーから 512 KB のカメラフレームまで 5 チャンネルを含む 10 秒間の模擬ロボット記録(合計約 102 MB)、そしてその記録をトピック、時間範囲、またはその両方で絞り込んで読むものです。各実行では書き込んだバイトと読み戻したメッセージ数を検証し、時間、ファイルサイズ、ピークメモリを記録します。Foxglove 自身の測定では、3.0 GHz に固定した AMD Ryzen AI MAX+ 395 で RAM 上のファイルシステムに書き込んだ場合、百万件メッセージのテストでの C++ の LZ4 書き込みは2026年1月の約 8 倍の速さになり、Rust のそのテストでの書き込み時間は半分未満になりました。向上の一部はコードの高速化ではなく既定値の変更によるものです。Go と C++ は最速の LZ4 設定を使うようになり、ファイルは 15% から 30% 大きくなります。一方 C++ の zstd はレベル 3 に変わり、書き込みが遅くなる代わりにファイルは約 31% 小さくなりました。公開された結果は書き込みのみを対象としており、Foxglove は Python ライブラリが小さなメッセージではほかより大幅に遅いと述べています。

重要な理由

ロボティクスのチームは記録を使ってデバッグし、インシデントを調べ、学習データを集めます。ログは周りのツールが読めて初めて役に立ちます。現在のリリースで ros2 bag record を実行すると ROS 2 が書き出すのは MCAP ファイルで、Lichtblick、PlotJuggler、Rerun などのビューアもこの形式を受け付けます。そのため ROS の内外を問わず、ロボットのログに広く使われています。MIT のもとオープンで、成文化された仕様と登録済みのメディアタイプがあり、スキーマも自身で持つため、今日記録したデータは生成したコードがなくても後からデコードできます。管理しているのは商業企業の Foxglove ですが、リポジトリにある共通のベンチマーク環境を使えば、誰でも Foxglove の数字に頼らず自分のハードウェアでライブラリの性能を同じ方法で確かめられます。記録速度よりもクエリや可視化を重視して bag を保存したいチームには、Rerun の RRD 形式向け rosbag2 プラグインという選択肢もあります。

解決する課題

ロボットのログには速度もサイズも異なる多くのデータストリームが混在しますが、MCAP 以前は記録先のファイルがフレームワーク次第でした。ROS の外では読みにくい ROS 1 の bag、自身のメッセージ定義を含まない ROS 2 の SQLite データベース、あるいはツールごとに対応が必要な独自形式です。MCAP は、高速に書き込め、記録の中断にも耐え、一つのファイルにどんなシリアライズ方式でも収められ、インデックスでトピックと時間から検索できる、オープンで自己記述的なコンテナを提供します。六つの言語のライブラリがあるので、ツールはそれぞれパーサーを作らずに読み書きできます。

主なポイント

  • ロボットのログなどタイムスタンプ付きのパブリッシュ/サブスクライブデータ向けのオープンなコンテナファイル形式で、仕様は公開され、メディアタイプは application/vnd.mcap
  • シリアライズ方式に依存せず、ROS 1、ROS 2、Protobuf、FlatBuffers、JSON などを 一つのファイルに収め、各スキーマも内部に保存
  • 追記のみの書き込み、中断したファイルの復旧、zstd または LZ4 によるチャンク圧縮、トピックや時間範囲で読むためのインデックス
  • C++、Go、Python、Rust、Swift、TypeScript のライブラリと、現在は Rust で書かれたコマンドラインツール
  • 2023年5月23日リリースの ROS 2 Iron Irwini 以降、rosbag2 の標準ストレージ形式
  • 五つのライブラリ共通のベンチマーク環境と、2026年11月9日に公開された Foxglove 自身の書き込み結果
  • MIT ライセンスで、Foxglove がオープンに開発

対象

  • bag の記録、再生、変換を行う ROS 2 の開発者
  • Protobuf、JSON、FlatBuffers が混在するデータを 一つのログ形式で扱いたい、ROS を使わないロボティクスのチーム
  • ロボットのログを読み書きする必要があるデータツール、ビューア、パイプラインの開発者
  • 機械学習のためにロボットデータを集め、自己記述的でインデックス付きの記録を求めるチーム

制限事項

  • 形式と大半のライブラリは商業企業の Foxglove が管理しており、同社のロボティクス向けデータプラットフォームは商用製品
  • ライブラリの機能は同じではなく、サポート表によると、たとえば Rust にはタイムスタンプ順の読み込みがなく、Swift にはインデックスを使った順不同の読み込みがない
  • 2026年11月の記事の性能値は Foxglove 自身によるもので、RAM 上のファイルシステムに書き込む AMD Ryzen AI MAX+ 395 のマシン一台で測定されている
  • これらの結果は書き込みのみで、読み込み速度は公開された比較に含まれていない
  • Foxglove 自身の説明によると、Python ライブラリは小さなメッセージではほかよりかなり遅い
  • 圧縮やチャンク分割など書き込みの既定値は言語ごとにまだ異なり、同じデータでもファイルサイズや速度が変わることがある
  • インデックスはファイル末尾のサマリーセクションにあるため、閉じる前に途切れた記録は CLI で復旧するまでインデックスを持たない

このウェブサイトにはJavaScriptが必要です。オープンソースロボティクスプロジェクトを閲覧するにはJavaScriptを有効にしてください。