Skip to main content
Glama

Bagel を使えば、ロボティクス、ドローン、IoT データについて、平易な英語で質問できます。メッセージデータに対するすべての計算は DuckDB SQL であり、モデルによる推測ではありません。Bagel はクエリを表示するので、監査も可能です。

私の IMU センサーはオーバーヒートしていませんか?

Bagel はインテリジェントなエッジデータ削減パイプラインも備えています。イベントを記述すると、Bagel はロボット上で検出を実行し、重要なウィンドウだけを保持して残りを破棄します。MCP サーバーがこれらすべてを LLM の手に委ねます:Claude Code、Gemini、Cursor、または完全にローカルなモデルでも。

Bagel は、ロボティクスデータ向けの本格的な分析ツールキットを出荷した最初の MCP サーバーであり、LLM を本来あるべき場所、つまりログの前面に置き、ロボットの制御ループには決して介入させません。

🥯 主な機能

  • 平易な言語で質問: 深いドメイン知識は不要。

  • 透明な計算: 決定論的な SQL クエリ。ブラックボックスな LLM の計算はありません。

  • 自然言語によるパイプライン: 「急ブレーキの前後 10 秒を保持し、残りは破棄」:この一文が監査可能なパイプラインになります。1 バイトも書き込む前にプレビューされ、その後、単一フリート全体、またはエッジで常時実行されます。

  • 幅広い LLM サポート: Claude Code、Gemini、Cursor、Codex など。

  • Docker 化された環境: ローカルの依存関係は不要。

  • 拡張可能な機能: Bagel は新しいトリックを学習できます。

  • 幅広いフォーマット対応: データ形式が見つからない場合は、チケットを開いてください。

⚡️ クイックスタート

[!TIP] すでに Claude Code をお持ちですか? このリポジトリへのリンクを貼り付けて、希望する環境を Claude に伝えるだけです。

ROS2 Kilted 用に https://github.com/Extelligence-ai/bagel をセットアップしてください。

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 Kilted(最新)

ros2-jazzy

ROS2 Jazzy

ros2-iron

ROS2 Iron

ros2-humble

ROS2 Humble

ros1-noetic

ROS1 Noetic

ros1-noetic-cv

ROS1 Noetic + CV

px4

PX4 フライトログ

ardupilot

ArduPilot フライトログ

betaflight

Betaflight フライトログ

iot

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

ROS2 bag "./data/sample/ros2/mcap" のメタデータを要約してください。

これで完了です。あなたのデータと会話できます。

🔒 完全オフラインがお好みですか?

手順 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 のセットアップ手順書:

お使いの LLM が見つかりませんか?チケットを開いてください。

Related MCP server: Robotics MCP Server

🔌 Claude Code プラグイン

Bagel には Claude Code プラグインが付属しています。Claude にサーバーをいつ、どのように操作するか(ログトリアージ、パイプライン作成、ライブシンク、可視化エクスポート)を教える 4 つのスキルと、MCP 接続が自動的に配線されます。

/plugin marketplace add Extelligence-ai/bagel
/plugin install bagel@bagel

次に、データ形式に合わせてコンテナを起動します(クイックスタート参照)。プラグインはデフォルトで http://localhost:8000/sse に接続します。他の MCP クライアントは、サーバーサイドで list_agent_capabilities ツールを介して同じワークフローを発見できます。

重要なものを保持し、残りは破棄

ロボットは、移動できる以上のデータを記録します。Bagel は質問を検出器に変え、データが記録されている場所で実行し、実際のイベント周辺のウィンドウだけを出荷します。

これを 1 回の会話で行う例:

上記のセッション:20 分(1,200 秒)の録画と、プロンプト「−10 m/s² より強い減速の前後 10 秒を保持する」。プレビューでは 7 つのイベントを検出、4 つのウィンドウに統合し、1,200 秒のうち 92 秒(7.6%)を保持。実行では 2.1 GB のバッグが 161 MB に削減されます。これらの数値はデモ出力の例であり、測定ベンチマークではありません。比率はイベントウィンドウの持続時間を総持続時間で割ったもので、ワークロードに完全に依存します。

✅ サポートされているデータ形式

業界

フォーマット

ロボティクス

ROS1、ROS2、MCAP(任意のプロファイル)、Copper(MCAP エクスポート経由)、ROS テキストログ(~/.ros/log)

ドローン

PX4、ArduPilot、Betaflight

自動車

ASAM MDF4(.mf4)、CAN キャプチャ(.blf/.asc + DBC)· ベータ

IoT

MQTT(ライブ、Sparkplug B)、PostgreSQL / TimescaleDB、InfluxDB 3

ハードウェア状態

WaffleForm スナップショット(.waffleform.yaml)、waffle-iron による自動検出 · ベータ

🆚 Bagel と既存ツールの比較

あなたはすでに ros2 *、PlotJuggler、grep を使っています。Bagel はそれらを置き換えるものではありません。それらを使うために必要な作業を Bagel が代わりに行い、結果をツールに引き渡します:

現在の作業

代わりに Bagel に質問

メタデータ取得に ros2 bag info

"このバッグを要約して":同じプロンプトが PX4、ArduPilot、MCAP、MQTT、Postgres でも動作

ros2 topic echo /imu で生の値を目視確認

"IMU の z 軸最大減速度は?5 秒間の移動平均は?" · 内部は本物の SQL:ピーク値、移動平均、パーセンタイル、トピック間相関

イベントを探すために PlotJuggler のタイムラインをスクロール

"−10 m/s² 未満の減速をすべて見つけて、±30 秒のスニペットを切り出して":その後、事前フレーム化されたレイアウト で結果を PlotJuggler で開く

rqt_console、または ~/.ros/log の grep

"~/.ros/log の ERROR を読み取って、何が問題だったか教えて":トレースバックも含まれ、バッグは不要

2 つのターミナルで 2 つのトピックをエコーし、スプレッドシートで相関を取る

"電流と電圧の相関は?":トピックは 1 つの SQL 関係に存在するので、結合と corr() は 1 つの質問で可能

ros2 bag record -a でディスクを監視

常時エッジパイプライン:連続録画、イベントウィンドウのみ保持、残りは破棄

200 個のバッグに対する bash ループ

"このパイプラインをフォルダ内のすべてのバッグに実行して":1 つのパイプライン、フリート全体、統合レポート付き

ロボットからデータを出荷するための scp/aws s3 sync スクリプト

アップロードをパイプラインステップとして 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 は最も関連性の高いトピックを特定し、その意味と構造を解釈します。そして、関連するトピックメッセージを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 🐱💤🎯

📚 ガイド

📦 インテグレーション

  • Rerun · 「そのイベントを Rerun で表示」:すぐに開ける録画として任意の時間枠

  • Lichtblick / Foxglove · イベントウィンドウを MCAP + どちらかのビューア用の事前フレーム化レイアウトで提供

  • PlotJuggler · Bagel の MCAP 出力を直接開く;一文で事前フレーム化されたセッション、フラット化された CSV/Parquet エクスポート

  • Cloudini · cloudini 圧縮ポイントクラウドをデコード、または bag の PointCloud2 トピックを CompressedPointCloud2 に圧縮

  • Slack · パイプラインが作動したときに運用チャンネルに投稿:「🚨 {アセット} で急ブレーキ」

  • LeRobot (ベータ版) · 検出されたイベントがトレーニングエピソードになる:LeRobotDataset v3.0

🚧 制限事項

既知の荒削りな部分を、苦労して見つけなくても済むようにお伝えします:

  • 2つのフォーマットはベータ版です。 自動車 MDF4/CAN リーダーは、それらを読み取るのと同じライブラリ(asammdf、python-can)で生成したファイルに対して検証されています。実際の CANape/INCA/Vector が生成したキャプチャはまだテストベンチを通過していません。LeRobot エクスポートは実際の lerobot パッケージでクリーンにロードテストされますが、Bagel エクスポートからトレーニングされたポリシーはまだありません。

  • 削減率はワークロード依存であり、ベンチマークされていません。 削減率はイベントウィンドウの継続時間を総継続時間で割ったものです。静かな録音は劇的に削減されますが、イベントの多い録音はそれほどでもありません。この README の数値は説明用のデモ出力であり、測定されたベンチマークではありません。

  • SSE がドキュメント化されたトランスポートです。 Streamable HTTP は既にワイヤリングされています(MCP_TRANSPORT=streamable-http)が、compose は設定を転送せず、クライアントの Runbook もそれをカバーしていないため、現在は SSE がサポートされるパスです(#168)。

  • MCP エンドポイントに認証はありません。 設計上、localhost のみにバインドされます。データベースソケットのように扱い、マシン外で共有する前に SECURITY.md を参照してください。

  • 小さなローカルモデルはマルチステップパイプラインに苦戦します。 4-8B モデルはツール選択と単純な SQL を処理できますが、イベントウィンドウ削減やマルチトピック結合にはより大きなモデルが必要です。ローカル LLM ガイドを参照してください。

  • ライブデータベースのエンドツーエンドテストは CI の外で実行されます。 InfluxDB と Postgres スイートの純粋なテストは CI 内で実行されますが、ライブエンドツーエンドのケースは指定されたインスタンスに対してのみ実行されます。ROS bag 書き込みパスを含むその他すべては CI 内で実行されます。

🫶 コントリビューション

皆様のご協力をお待ちしております!プロジェクトを支援する最も簡単な方法は、GitHub で ⭐ を付けることです。

その他の素晴らしいコントリビューション方法:

  • 新機能のリクエスト

  • バグの報告

  • ドキュメントの改善

  • 新しい機能の追加

コントリビューションの前に、ガイドラインをご確認ください。

Discord サーバーでの会話にご参加ください。私たちは定期的にそこで交流しています。

📄 ライセンス

Bagel は Apache License 2.0 の下でオープンソースです。

Available Tools

25 tools
delete_capabilityDelete a user capabilityA
DestructiveIdempotent

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 pipelineA
DestructiveIdempotent

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 sourceA
Read-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 sourceA
Read-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)A
Idempotent

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 / FoxgloveA
Idempotent

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 PlotJugglerA
Idempotent

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 viewerA
Idempotent

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 pipelineA
Read-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 capabilitiesA
Read-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 topicsA
Read-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 capabilitiesA
Read-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 pipelinesA
Read-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)A
Read-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 reductionA
Read-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 SQLA
Read-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 sourceA
Read-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 fileA
Read-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 capabilityA
DestructiveIdempotent

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 fileB
Idempotent

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 messagesA
Destructive

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 subscriptionsA
Idempotent

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

    A4/5.0

    Scored across 25 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      C
      quality
      B
      maintenance
      Provides 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.
      25
      12
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 PyPI
      MIT