Bagel
Bagel을 사용하면 로보틱스, 드론, IoT 데이터에 대해 일반 영어로 질문할 수 있습니다. 메시지 데이터에 대한 모든 계산은 모델의 추측이 아닌 DuckDB SQL이며, Bagel은 감사할 수 있도록 쿼리를 직접 보여줍니다.
IMU 센서가 과열되고 있나요?
Bagel은 또한 지능형 엣지 데이터 축소 파이프라인을 제공합니다. 이벤트를 설명하면 Bagel이 로봇에서 감지를 실행하고 중요한 윈도우만 유지한 채 나머지는 버립니다. MCP 서버가 이 모든 것을 LLM의 손에 넘깁니다: Claude Code, Gemini, Cursor, 또는 완전히 로컬 모델까지 말이죠.
Bagel은 로보틱스 데이터를 위한 실제 분석 도구 키트를 탑재한 최초의 MCP 서버였으며, LLM이 있어야 할 자리를 지켜줍니다: 로그 앞에, 절대 로봇의 제어 루프 안에는 두지 않습니다.
🥯 주요 기능
일반 언어로 질문: 깊은 도메인 전문 지식이 필요 없습니다.
투명한 계산: 결정적 SQL 쿼리. 블랙박스 LLM 수학이 없습니다.
자연어 파이프라인: "모든 급제동 전후 10초 유지, 나머지는 버리기": 한 문장이 감사 가능한 파이프라인이 됩니다. 바이트가 기록되기 전에 미리 보고, 그런 다음 한 번, 플릿 전체, 또는 엣지 상시로 실행합니다.
폭넓은 LLM 지원: Claude Code, Gemini, Cursor, Codex 등.
Docker화된 환경: 로컬 종속성이 필요 없습니다.
확장 가능한 기능: Bagel은 새로운 기술을 배울 수 있습니다.
광범위한 형식 지원: 데이터 형식이 없나요? 티켓을 열어주세요.
⚡️ 빠른 시작
[!TIP] 이미 Claude Code가 있나요? 이 저장소 링크를 붙여넣고 원하는 환경을 Claude에게 말하기만 하면 됩니다:
https://github.com/Extelligence-ai/bagel을 ROS2 Kilted용으로 설정해 줘.
Claude가 저장소를 클론하고 Docker를 시작한 다음 MCP 연결을 설정해 줍니다.
📋 사전 요구 사항
Docker Desktop과 Claude Code를 설치합니다 (또는 MCP를 지원하는 다른 LLM).
1. Bagel 클론 및 시작
git clone https://github.com/Extelligence-ai/bagel.git && cd bagel
docker compose run --service-ports ros2-kilted[!TIP] 포트 8000이 이미 사용 중인가요?
MCP_SERVER_PORT를 다른 값으로 설정하세요. 예를 들어MCP_SERVER_PORT=8100 docker compose run --service-ports ros2-kilted처럼 말이죠. 그리고 2단계에서 해당 포트를 사용하세요.
환경에 맞는 서비스를 선택하세요:
서비스 | 사용 사례 |
| ROS2 Kilted (최신) |
| ROS2 Jazzy |
| ROS2 Iron |
| ROS2 Humble |
| ROS1 Noetic |
| ROS1 Noetic + CV |
| PX4 비행 로그 |
| ArduPilot 비행 로그 |
| Betaflight 비행 로그 |
| IoT / MQTT (실시간) |
[!TIP] Bagel에 로컬 파일 접근 권한을 부여하려면 Docker를 시작하기 전에
compose.yaml을 편집하세요: 선택한 서비스에서volumes섹션의 주석을 해제하고 업데이트하세요.
이 출력이 나올 때까지 기다리세요:
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)2. Claude Code 연결
새 터미널에서:
claude mcp add --transport sse bagel http://localhost:8000/sse[!NOTE] 보안을 위해 MCP 엔드포인트는
localhost에만 바인딩됩니다 (LAN에는 노출되지 않음). 다른 머신과 공유하려면compose.yaml에서127.0.0.1접두사를 제거하고 앞에 인증된 프록시를 두세요: SECURITY.md를 참조하세요.
3. 프롬프트
claude"./data/sample/ros2/mcap" ROS2 백의 메타데이터를 요약해 줘.
끝입니다: 이제 데이터와 대화하고 있는 것입니다.
🔒 완전히 오프라인을 선호하나요?
2단계를 로컬 모델로 바꾸세요: 데이터 와 LLM이 모두 머신에 남습니다:
brew install ollama && ollama serve & # or ollama.com
ollama pull qwen3:8b
uvx ollmcp --mcp-server-url http://localhost:8000/sse --model qwen3:8b모델 선택, 기대 사항, 문제 해결: 로컬 LLM 가이드.
Bagel은 MCP를 지원하는 모든 LLM과 작동합니다. 테스트된 대안에 대한 설정 런북:
LLM을 찾을 수 없나요? 티켓을 열어주세요.
Related MCP server: Robotics MCP Server
🔌 Claude Code 플러그인
Bagel은 Claude Code 플러그인을 제공합니다: 서버를 언제, 어떻게 구동할지 Claude에게 가르치는 네 가지 스킬(로그 트리아지, 파이프라인 작성, 실시간 싱크, 시각화 내보내기)과 자동으로 연결되는 MCP 연결이 포함되어 있습니다.
/plugin marketplace add Extelligence-ai/bagel
/plugin install bagel@bagel그런 다음 데이터 형식에 맞는 컨테이너를 시작하세요(빠른 시작 참조): 플러그인은
기본적으로 http://localhost:8000/sse에 연결됩니다. 다른 MCP 클라이언트도
list_agent_capabilities 도구를 통해 서버 측에서 동일한 워크플로를 발견할 수 있습니다.
중요한 것은 유지하고, 나머지는 버리세요
로봇은 이동할 수 있는 것보다 더 많은 데이터를 기록합니다. Bagel은 질문을 감지기로 바꾸고, 데이터가 기록되는 곳에서 실행하며, 실제 이벤트 주변의 윈도우만 전송합니다.
한 번의 대화로 표현하면 이렇습니다:
위 세션: 20분(1,200초) 녹음과 "−10 m/s²보다 큰 모든 감속 전후 10초를 유지해" 프롬프트. 미리보기는 7개의 이벤트를 감지하고 4개의 윈도우로 병합하여 1,200초 중 92초(7.6%)를 유지합니다. 실행은 2.1GB 백을 161MB로 줄입니다. 이 수치는 측정된 벤치마크가 아닌 예시 데모 출력입니다: 비율은 이벤트 윈도우 지속 시간을 전체 지속 시간으로 나눈 값이므로 전적으로 워크로드에 달려 있습니다.
✅ 지원되는 데이터 형식
산업 | 형식 |
로보틱스 | ROS1, ROS2, MCAP (모든 프로파일), Copper (MCAP 내보내기 경유), ROS 텍스트 로그 ( |
드론 | PX4, ArduPilot, Betaflight |
자동차 | ASAM MDF4 ( |
IoT | MQTT (실시간, Sparkplug B), PostgreSQL / TimescaleDB, InfluxDB 3 |
하드웨어 상태 | WaffleForm 스냅샷 ( |
🆚 Bagel vs. 이미 사용 중인 도구
이미 ros2 *, PlotJuggler, grep을 가지고 있습니다. Bagel은 그것들을 대체하지 않습니다:
그것들이 애써 찾게 만드는 질문에 답한 다음, 그 도구들에게 넘겨줍니다:
오늘 이렇게 하고 있다 | 대신 Bagel에게 물어보세요 |
메타데이터를 위해 | "이 백을 요약해 줘": 동일한 프롬프트가 PX4, ArduPilot, MCAP, MQTT, Postgres에서도 작동합니다 |
| "/imu에서 z축 최대 감속도는 얼마야? 5초 이동 평균은?" · 실제 SQL 기반: 최댓값, 이동 평균, 백분위수, 토픽 간 상관 관계 |
이벤트를 찾기 위해 PlotJuggler 타임라인을 샅샅이 뒤짐 | "−10 m/s² 미만의 모든 감속을 찾아 ±30초 스니펫을 잘라줘": 그런 다음 결과를 미리 구성된 레이아웃으로 PlotJuggler에서 엽니다 |
| "~/.ros/log의 ERROR를 읽고 무엇이 잘못되었는지 알려줘": 트레이스백 포함, 백 불필요 |
두 토픽을 두 터미널에서 에코하고 스프레드시트에서 상호 연관 | "전류와 전압의 상관 관계는 얼마야?": 토픽이 하나의 SQL 관계에 있으므로 조인과 |
| 상시 엣지 파이프라인: 연속 기록, 이벤트 윈도우만 유지, 나머지는 버리기 |
200개 백에 대한 bash 루프 | "폴더의 모든 백에 이 파이프라인을 실행해 줘": 하나의 파이프라인, 전체 플릿, 통합 보고서 포함 |
데이터를 로봇에서 옮기는 | 파이프라인 단계로 S3, GCS 또는 Azure에 업로드, 이미 있는 파일은 체크섬으로 건너뜀 |
형식별로 다른 뷰어: PX4용 FlightPlot, ArduPilot용 MAVExplorer, Betaflight용 Blackbox Explorer | 모든 형식에 대해 동일한 대화, ROS, MCAP, MQTT, Postgres, InfluxDB 포함 |
질문마다 일회용 pandas 스크립트 작성 | 질문을 하세요. Bagel이 쿼리를 작성하고 실행합니다 |
일반 언어 한 문장, 하나의 답변, 내일 삭제할 명령 파이프라인과 스크립트 대신 말이죠.
💬 무엇을 프롬프트할 수 있나요?
Bagel에게 거의 모든 것을 물어볼 수 있습니다. 예를 들어:
/spot/status/battery_states토픽에서 전류와 전압의 상관 관계는 얼마야?
로봇이 포트홀에 부딪힌 것 같아. z축 급감속이 있었는지 확인해서 확인해 줄 수 있어?
드론이 -10 m/s²보다 더 급하게 감속할 때마다 전후 10초를 유지하십시오. 나머지는 모두 버리십시오.
지난주 이후로 이 로봇에 변경된 사항이 있나요?
이제 Bagel을 시험해 볼 시간입니다: 드론이 배럴 롤을 하는 것을 잡을 수 있을까요? 스포일러: 🎉 완전히 잡아냅니다.
💡 Bagel 작동 방식
질문을 하면 Bagel은 데이터 소스의 메타데이터와 토픽을 분석하여 높은 수준의 이해를 구축합니다.
프롬프트에 따라 추가 검사가 필요하면 Bagel은 가장 관련성 높은 토픽을 식별하고 그 의미와 구조를 해석합니다. 그런 다음 Bagel은 관련 토픽 메시지를 Apache Arrow 파일에 쓰고 DuckDB를 사용하여 이에 대한 쿼리를 생성 및 실행합니다.
이 과정은 필요에 따라 반복되며, Bagel이 질문에 가장 적합한 답을 찾을 때까지 새 쿼리를 실행합니다.
LLM은 언어에 능숙하지만 수학에는 어려움을 겪습니다. Bagel은 결정론적 DuckDB SQL 쿼리를 생성하여 이를 극복합니다. 이러한 쿼리는 감사할 수 있도록 표시되며, 사용자는 Bagel을 안내하여 오류를 수정할 수 있습니다.
🐶 Bagel에게 새로운 트릭 가르치기
Bagel은 POML 파일을 통해 새로운 기능을 학습합니다: 지연 시간 통계 계산과 같은 "트릭"을 설명하는 구조화된 명령어 집합입니다.
✍️ .poml 파일 만들기
예를 들어 ./src/agent/examples/woof.poml을 정의해 보겠습니다.
<poml>
<task>
Count the topics in the data source.
If the count is odd, say "woof", else say "meow".
</task>
<output-format>
Return the sound, the topic count, and a few cute emojis. Nothing else.
</output-format>
</poml>🗣️ 기능 사용하기
Bagel에 프롬프트를 입력하세요:
ROS2 bag
./data/sample/ros2/mcap에서 POML 기능./src/agent/examples/woof.poml을 실행하세요.
결과:
meow 🐱 4 topics 🐱💤🎯📚 가이드
자연어 파이프라인 · 모델: 케이던스, 게이트 및 작업; 미리보기 → 실행 → 저장 → 배치 → 경계에서 대기
이벤트 기반 데이터 축소 · 이벤트 감지, 주변 윈도우 유지 (스니펫 또는 단일 축소 bag), 플릿 전체에 걸쳐 배치, 클라우드에 업로드
rosbridge를 통한 실시간 ROS2 로봇 · 단계별 튜토리얼
ROS 텍스트 로그 · bag을 열지 않고
~/.ros/log오류 및 경고 검사MQTT · 실시간 IoT 토픽, Sparkplug B, 에지 녹화
PostgreSQL / TimescaleDB · 모든 테이블은 토픽입니다
InfluxDB 3 · 모든 측정값은 토픽입니다
자동차 MDF4 및 CAN (베타) · 채널 그룹과 DBC 메시지는 토픽입니다. 단위도 함께 제공됩니다.
로컬 LLM · Ollama로 완전 오프라인: 데이터와 모델이 컴퓨터를 떠나지 않습니다.
📦 통합
Rerun · "Rerun에서 그 이벤트를 보여줘": 열 준비가 된 녹화본으로 모든 시간 윈도우
Lichtblick / Foxglove · 이벤트 윈도우를 MCAP + 두 뷰어용 사전 프레임 레이아웃으로
PlotJuggler · Bagel의 MCAP 출력을 직접 열기; 한 문장 사전 프레임 세션, 평면화된 CSV/Parquet 내보내기
Cloudini · cloudini 압축 포인트 클라우드 디코드, 또는 bag의 PointCloud2 토을 CompressedPointCloud2로 압축
Slack · 파이프라인이 작동 시 운영 채널에 게시: "🚨 {자산}에 급제동"
LeRobot (베타) · 감지된 이벤트가 학습 에피소드가 됩니다: LeRobotDataset v3.0
🚧 제한 사항
힘들게 발견하지 않도록 알려드리는 알려진 거친 부분들:
두 가지 포맷이 베타입니다. 자동차 MDF4/CAN 리더는 동일한 라이브러리(
asammdf,python-can)로 생성한 파일에 대해 검증되었습니다. 실제 CANape/INCA/Vector 생성 캡처는 아직 테스트 벤치를 거치지 않았습니다. LeRobot 내보내기는 실제lerobot패키지로 깔끔하게 로드 테스트되었지만, 아직 Bagel 내보내기로 정책을 훈련한 사례는 없습니다.축소 비율은 워크로드에 따라 달라지며, 벤치마크되지 않았습니다. 비율은 이벤트 윈도우 시간 / 전체 시간입니다: 조용한 녹화는 크게 축소되지만, 이벤트가 많은 녹화는 훨씬 덜 축소됩니다. 이 README의 수치는 측정된 벤치마크가 아닌 설명용 데모 출력입니다.
SSE가 문서화된 전송 방식입니다. 스트리밍 가능 HTTP는 이미 연결되어 있지만(
MCP_TRANSPORT=streamable-http), compose가 설정을 전달하지 않고 클라이언트 런북도 아직 다루지 않아서, SSE가 현재 지원되는 경로입니다(#168).MCP 엔드포인트에 인증이 압습니다. 설계상 로컬호스트에만 바인딩되며, 데이터베이스 소캣처럼 다루고 SECURITY.md를 참조하여 컴퓨터 외부로 공유하기 전에 확인하십시오.
작은 로컬 모델은 다단계 파이프라인에 어려움을 겪습니다. 4-8B 모델은 도구 선택과 간단한 SQL을 처리합니다. 이벤트 윈도우 축소 및 다중 토픽 조인은 더 큰 모델이 필요합니다. 로컬 LLM 가이드를 참조하십시오.
실시간 데이터베이스 엔드투엔드 테스트는 CI 외부에서 실행됩니다. InfluxDB 및 Postgres 스위트의 순수 테스트는 CI에서 실행됩니다. 실시간 엔드투엔드 케이스는 사용자가 지정한 인스턴스에 대해서만 실행됩니다. ROS bag 쓰기 경로를 포함한 다른 모든 것은 CI에서 실행됩니다.
🫶 기여하기
여러분의 도움을 환영합니다! 프로젝트를 지원하는 가장 쉬운 방법은 GitHub에 ⭐를 주는 것입니다.
기여할 수 있는 다른 좋은 방법:
새로운 기능 요청
버그 보고
문서 개선
새로운 기능 추가
기여하기 전에 가이드라인을 검토해 주세요.
Discord 서버에서 대화에 참여하세요. 우리는 정기적으로 그곳에 있습니다.
📄 라이선스
Bagel은 Apache 라이선스 2.0에 따라 오픈 소스입니다.
Available Tools
25 toolsdelete_capabilityDelete a user capabilityADestructiveIdempotent
Delete a capability previously saved with save_agent_capability, by the exact, full name list_agent_capabilities reports (user/-prefixed) -- a bare slug is rejected, since a user capability's name can shadow a builtin of the same stem. Only user-saved capabilities can be deleted -- builtins shipped with Bagel refuse with a clear message. An unknown name raises rather than silently no-op-ing, listing the user capabilities that do exist.
Inputs: name (required). Returns: object
delete_pipelineDelete a saved pipelineADestructiveIdempotent
Delete exactly one pipeline YAML file previously written by save_pipeline, by the same name list_pipelines reports. Confined to the trusted pipelines directory (settings.PIPELINES_DIRECTORY) -- there is no directory argument, so this can never be pointed at an arbitrary path -- and a name that would resolve outside it is refused before anything is touched. Deleting an unknown name raises rather than silently no-op-ing, listing the names that do exist -- so a second delete of the same name also raises.
Inputs: name (required). Returns: object
describe_data_sourceDescribe a data sourceARead-onlyIdempotent
Inspect a robotics, drone, or IoT log first: returns source metadata, available topics, and instructions for summarizing them. Use describe_topic next for field schemas before SQL. Does not return message rows or detect anomalies. Paths are resolved on the Bagel server; runtime and schema support depend on the selected service.
Inputs: path (required), args. Returns: result
describe_topicDescribe a topic in a data sourceARead-onlyIdempotent
Inspect one known topic before writing SQL or event predicates. Returns its DuckDB schema, original message definition, and query instructions, without message rows. Discover topic names with describe_data_source. Confirm units from the definition or user; do not infer units from field names.
Inputs: path (required), topic (required), args. Returns: result
export_for_lerobotExport event windows as a LeRobot training dataset (beta)AIdempotent
Write selected event windows as a LeRobotDataset v3.0: one episode per window, scalar signals grouped into feature vectors and resampled to a uniform fps using last observation carried forward. Returns the dataset directory, episode/frame counts, and loading instructions. Choose this for robot-learning dataset preparation, not interactive viewing or model training. Beta: load compatibility tested; actual training-run validation remains outstanding.
Inputs: fps (required), path (required), task (required), topics (required), +5 more. Returns: object
export_for_lichtblickExport an event window for Lichtblick / FoxgloveAIdempotent
Write a selected time window as JSON-encoded MCAP plus a plot layout for Lichtblick or Foxglove; returns paths, curves, and opening instructions. Choose this for those viewers, not byte-preserving native ROS/CDR export. Inspect topic schemas and use source timestamps in seconds. Automatically selects up to eight numeric plot curves unless signals are specified. Requires a separate viewer; does not launch it.
Inputs: path (required), topics (required), end_seconds (required), start_seconds (required), +3 more. Returns: object
export_for_plotjugglerExport an event window for PlotJugglerAIdempotent
Write a selected time window as flattened scalar CSV plus a PlotJuggler XML layout; returns paths, plotted curves, and an opening command. Choose this for scalar plotting in PlotJuggler, not native bag preservation. Inspect topic schemas and use inclusive source timestamps in seconds. Automatically selects up to eight numeric curves unless signals are specified. Requires the separate viewer to open; does not launch it.
Inputs: path (required), topics (required), end_seconds (required), start_seconds (required), +3 more. Returns: object
export_for_rerunExport an event window for the Rerun viewerAIdempotent
Write a selected time window as scalar time series in a Rerun .rrd recording; returns its path, signals, and an opening command. Choose this when the user requests Rerun. Requires rerun-sdk (uv sync --group viz) and a separate viewer. Inspect topic schemas and use source timestamps in seconds. This exporter does not produce camera or 3D scene replay and does not launch the viewer.
Inputs: path (required), topics (required), end_seconds (required), start_seconds (required), +3 more. Returns: object
get_pipelineRead a saved pipelineARead-onlyIdempotent
Return the full configuration of one pipeline saved by save_pipeline, by the name list_pipelines reports, so it can be inspected, edited and saved again or passed to run_pipeline. Confined to the trusted pipelines directory (settings.PIPELINES_DIRECTORY); a name resolving outside it is refused.
Inputs: name (required). Returns: object
list_agent_capabilitiesList agent capabilitiesARead-onlyIdempotent
List every capability available to run: the predefined .poml capabilities shipped with Bagel, plus any user-saved capabilities (.poml or .md, named with a user/ prefix) discovered under the user-capabilities directory. Each entry has a name, a path to pass to run_poml_capability, and a one-line summary. Use this to discover available capabilities instead of guessing file paths.
Inputs: no named parameters. Returns: result
list_live_topicsList available live topicsARead-onlyIdempotent
Discover topic names from a live broker or ROS bridge before subscribing. Supported type_ values: mqtt, ros1.bridge, ros2.bridge. Requires a reachable service; specify host and port when defaults do not fit. Returns topic names without starting a persistent recording. Use describe_data_source for an existing recorded log.
Inputs: type_ (required), args, host, port. Returns: result
list_pipeline_capabilitiesList pipeline capabilitiesARead-onlyIdempotent
Discover available task and gate modules before authoring pipeline YAML. Returns module paths, constructor parameters, summaries, and availability. These are executable building blocks, not saved workflows: use list_pipelines for saved configs and list_agent_capabilities for reusable agent instructions.
Inputs: include_unavailable. Returns: result
list_pipelinesList saved pipelinesARead-onlyIdempotent
List the pipeline YAML files saved by save_pipeline in the trusted pipelines directory (settings.PIPELINES_DIRECTORY): each entry's name, path, and a one-line summary (task count, site/asset, and cadence). Use this to discover what has already been saved before reusing, editing, or deleting it -- instead of guessing file names.
Inputs: no named parameters. Returns: result
preview_anomaliesPreview what the anomaly gate would flag (beta)ARead-onlyIdempotent
Dry-run the on-robot anomaly screen over a recorded log without calling any decision model or writing artifacts. Learns a rolling baseline the way the src.pipeline.gates.anomaly gate does, then reports every window the screen would flag (mean shift, extreme sample, topic dropout) with the signal, value and z-score, flag counts per signal, and plain-language advice (signals that drift by design, warm-up longer than the log). Inspect topics first and pass signals as rates and errors (accelerations, angular rates, currents), never positions or orientations. Use it to choose signals and thresholds before saving an anomaly pipeline. It models screen mode with the decision model confirming every flag, every: N seconds cadences, and a gate that sees every fire (list the anomaly gate first).
Inputs: path (required), window_seconds (required), args, topics, +8 more. Returns: object
preview_pipelinePreview an event-driven data reductionARead-onlyIdempotent
Preview an event-window reduction without writing artifacts. Inspect source and topic schemas first, then provide a SQL boolean predicate and nonnegative pre/post seconds. Detects false-to-true transitions, debounces nearby events, merges overlapping windows, and returns event timestamps, intervals, total seconds, and kept seconds/fraction. Report these results and obtain user confirmation before executing the reduction with run_pipeline or run_pipeline_batch. Does not predict output byte size.
Inputs: path (required), predicate (required), event_topic (required), pre_seconds (required), +3 more. Returns: object
query_messagesQuery topic messages with SQLARead-onlyIdempotent
Answer quantitative questions with read-only DuckDB SQL over one topic: filtering, aggregates, downsampling, and event evidence. Call describe_data_source and describe_topic first; use the returned schema and show the SQL to the user. Returns rows as dictionaries. Use read_loggings for textual diagnostics. Time bounds are inclusive source timestamps in seconds, not offsets from the first message.
Inputs: path (required), topic (required), sql_statement (required), args, +2 more. Returns: result
read_loggingsRead logging messages from a data sourceARead-onlyIdempotent
Read textual INFO/WARN/ERROR diagnostics from a recorded source, optionally within inclusive source-time bounds in seconds. Returns logging records, or an empty list when no logging topics exist. Use query_messages for numerical signals, statistics, and threshold detection; empty diagnostics do not prove a healthy log.
Inputs: path (required), args, end_seconds, start_seconds. Returns: result
run_pipelineRun a pipelineA
Execute one pipeline config against its single config.path after configuration and input validation. For event reductions, first call preview_pipeline, report events and kept seconds, and obtain user confirmation. Returns pipeline status, run counts, and artifact paths; inspect status for failures. Tasks may write files or contact external services. Use save_pipeline to store without executing, or run_pipeline_batch for multiple sources.
Inputs: config (required). Returns: object
run_pipeline_batchRun a pipeline across many data sources (batch)A
Execute one pipeline config for multiple explicit source paths or globs, overriding config.path for each source. Each source runs independently; returns per-source statuses/errors and totals. For event reductions, preview each source to be reduced and obtain confirmation of the batch scope before executing. Tasks may write files or contact external services. Use run_pipeline for a single source. A glob matching nothing is treated as a literal path.
Inputs: paths (required), config (required). Returns: object
run_poml_capabilityRun a capability defined in a POML fileARead-onlyIdempotent
Load reusable agent instructions from a POML or Markdown file; returns a prompt for the calling agent to follow. Discover paths with list_agent_capabilities. POML accepts template context; Markdown rejects nonempty context. Loading the prompt does not itself analyze data, execute a pipeline, or write reduction artifacts. Use run_pipeline for an approved executable pipeline config.
Inputs: poml_path (required), poml_context. Returns: result
save_agent_capabilitySave a user capabilityADestructiveIdempotent
Save a reusable workflow as a named capability so it can be discovered with list_agent_capabilities and run with run_poml_capability in any future session. Content may be POML (validated before saving; supports context parameterization) or plain markdown instructions. Writes only to the user-capabilities directory; builtin capabilities cannot be modified.
Inputs: name (required), content (required), overwrite. Returns: object
save_pipelineSave a pipeline to a YAML fileBIdempotent
Persist a pipeline configuration to a YAML file so it can be reused, edited, or run later with run.py. Returns the path to the written file.
Inputs: name (required), config (required), directory. Returns: result
snap_hardwareSnapshot robot hardware into a WaffleForm (experimental beta)A
Auto-detect the robot's current hardware, firmware, and software using waffle-iron and return the resulting hardware state. Requires the waffle CLI on PATH (cargo install waffle-iron). The WaffleForm it writes is immediately queryable as a data source.
Inputs: directory. Returns: object
subscribe_live_topicsSubscribe to live topic messagesADestructive
Start a background subscription to mqtt, ros1.bridge, or ros2.bridge and persist messages locally; returns the sink directory for subsequent analysis. Use list_live_topics first. An optional pipeline runs continuously on incoming messages and may write or upload artifacts. overwrite=True clears existing topic buffers. Stop it with unsubscribe_live_topics. Not for inspecting an existing file.
Inputs: type_ (required), args, host, port, +3 more. Returns: result
unsubscribe_live_topicsStop live topic subscriptionsAIdempotent
Stop topics started by subscribe_live_topics on a running mqtt, ros1.bridge, or ros2.bridge subscription (same type_, host and port). Omit topics to stop all of them. A standing pipeline finishes its queued runs and its end-of-stream run first, which may write or upload artifacts. Recorded messages stay in the returned sink directory for analysis. Once nothing is subscribed the connection is closed. Never opens a connection: errors if there is no running subscription there.
Inputs: type_ (required), host, port, topics. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool targets a distinct resource or action: capabilities, pipelines, data-source inspection, live-topic subscriptions, and exports are all clearly separated. Similar-sounding tools such as run_poml_capability versus run_pipeline, list_pipelines versus list_pipeline_capabilities, and query_messages versus read_loggings are explicitly cross-referenced and disambiguated in their descriptions.
The set overwhelmingly follows a verb_noun snake_case pattern with consistent list/save/delete/run/preview/export verbs. Minor deviations include run_poml_capability supporting Markdown despite the POML-specific name, delete_capability breaking the save_agent_capability/list_agent_capabilities symmetry, and the somewhat vague snap_hardware verb.
With 25 tools the server sits exactly in the heavy 16-25 range, making it borderline even though the domain is fairly broad. The pipeline and capability management clusters plus the four exporter tools add significant surface area, though none of the tools feel entirely redundant.
Core lifecycles are covered well: capabilities have list/save/run/delete, pipelines have save/get/list/delete/run/batch/preview, and data inspection covers schemas, SQL queries, and textual logs. Minor gaps remain, such as no tool to enumerate recorded data sources or produce byte-preserving native bag exports, but agents can work around these.
Maintenance
Related MCP Connectors
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Analytical memory for AI agents: a real Postgres queried in plain English over MCP. One command.
Query, join, profile, clean and convert CSV/JSON/Parquet with server-side DuckDB over MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables language models to perform hardware engineering tasks including CAD part design and heat transfer simulations. Provides tool calls for building mechanical components and running thermal analysis through natural language interactions.-
- AlicenseCqualityBmaintenanceProvides unified control for both physical robots (ROS-based like Moorebot Scout, Unitree) and virtual robots in Unity3D/VRChat, enabling multi-robot coordination, environment generation, and automated 3D model creation.2512MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to control hardware devices like Arduino, Raspberry Pi, 3D printers, CNC machines, and custom robots via serial ports and HTTP. Provides tools for device discovery, command sending, sensor reading, servo control, G-code execution, and emergency stops with safety features.37 PyPIMIT
- AlicenseAqualityDmaintenanceProvides an MCP interface to the ROBOT command-line tool for OWL ontology editing, enabling operations like merging, reasoning, and conversion via natural language.261BSD 2-Clause "Simplified"