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를 활성화하세요.