Yahboom MCP

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

6 read · 4 write · 1 delete · 3 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Downloaded binary

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• audio

  Play/store/manage audio files through the USB voice module speaker. Operations: - play: upload a local .mp3/.wav, play immediately - sound: built-in sound effect (fart, ding, buzzer, clap, boo, circus, elevator, siren, applause, tada, sad_trombone, take_five, coin, zap, reveille, deguello, beep) - store: upload to ~/boomy_audio/ for permanent storage - play_stored: play a previously stored file by name - list_stored: list all stored audio files - delete_stored: remove a file from the depot - stop: kill all running playback ## Return Format {"success": bool, "operation": str, "status": st…

• lidarread-only

  LIDAR and map data from Yahboom or Dreame D20 Pro. [RATIONALE] Combined sensor: the Yahboom /scan topic gives per-sector obstacle distances; Dreame D20 Pro via DREAME_MAP_URL provides house floorplan maps. Single tool avoids tool-list bloat while keeping both scanning surfaces accessible. ## Return Format {"success": bool, "operation": str, "source": str, "result": {"obstacles": {...}, "nearest_m": float|null, ...}} ## Examples lidar(operation="read", source="yahboom") lidar(operation="read_dreame_map") lidar(operation="read_raw", source="auto")

• query_logsread-only

  Query the in-memory log ring buffer for recent log entries. Filter by source (logger name), level (INFO, WARNING, ERROR, DEBUG), or free-text search in the message body. Returns: dict with filtered log entries, count, total_matching.

• ros_node_info

  Get detailed information about a specific ROS 2 node. Reveals publishers, subscribers, and services for the specified node.

• ros_restart_bringup

  Remotely restart the Yahboom bringup nodes via SSH. Use this as a 'Nuclear Option' if the robot is unresponsive or nodes are missing.

• ros_resync

  Force a re-discovery of all ROS 2 topics and re-subscribe to sensors. Use this if telemetry (Battery, IMU) is missing while wheels still work.

• ros_topic_list

  List all active ROS 2 topics and their message types. Provides full visibility into the robot's sensory and control stack.

• show_robot_status_cardread-only

  Show Yahboom robot link status as a rich Prefab card. Reads the in-process bridge/video/SSH state (no network calls, works offline) and renders link state, uptime, and version — no need to parse JSON in chat. ## Return Format PrefabApp with the robot status card. ## Examples show_robot_status_card()

• yahboom_agent_mission

  LLM mission planner: natural-language goal (e.g. "find Benny") → structured JSON plan (intent, behavior, target_description, optional nav2_goal, …). Same logic as POST /api/v1/agent/mission. When publish_to_ros is true (default), publishes the plan as JSON on std_msgs/String (YAHBOOM_MISSION_TOPIC, default /boomy/mission) for boomy_mission_executor on the Pi. provider: auto | ollama | gemini (auto prefers Gemini if YAHBOOM_GEMINI_API_KEY is set). speak: if true, speaks voice_feedback from the plan via SSH voice module.

• yahboom_agentic_workflow

  Achieve a high-level robot goal by planning and executing a sequence of operations (SEP-1577). Uses sampling to let the LLM call get_robot_health, move_robot, and read_sensors as sub-tools. ## Return Format str: Summary of steps executed and outcome, or error message if the workflow failed. ## Examples yahboom_agentic_workflow(goal="patrol in a square and report battery") yahboom_agentic_workflow(goal="check health, then move forward 2 seconds")

• yahboom_demo

  Boomy show-floor demos: floor chalk art, social talkbot, and the interaction demos (dog meeting + cafe host). Operations: describe, draw, draw_status, draw_stop, talkbot, talkbot_status, talkbot_stop, found_dog, found_dog_status, found_dog_stop, cafe_host, cafe_host_status, cafe_host_stop, status, stop. draw — mecanum path drawing (patterns: smiley, heart, boomy_b). Two-color layers pause for chalk swap unless skip_color_swap_pause=True. talkbot — optional approach, PTZ wiggle, "Hi, I am Boomy. Who are you?", then listen/reply turns. Uses speech-mcp TTS when reachable, else espeak on Pi. f…

• yahboom_help_toolread-only

  Multi-level help system for the Yahboom MCP server. Supports drill-down: category (motion/sensors/connection/api/mcp_tools/startup/troubleshooting), then topic within each category. ## Return Format Without category: {"help": str, "categories": {...}} With category only: {"category": str, "description": str, "topics": {...}} With category+topic: {"category": str, "topic": str, "detail": str} ## Examples yahboom_help_tool() yahboom_help_tool(category="motion") yahboom_help_tool(category="connection", topic="wifi")

• yahboom_shutdowncan change or delete data

  Gracefully shut down the Yahboom MCP server process. Schedules an orderly exit after a short delay so in-flight responses can flush. The owning process (uvicorn daemon or stdio client) reaps it. ## Return Format {"success": bool, "message": str, "reason": str} ## Examples yahboom_shutdown() yahboom_shutdown(reason="robot packed up for the night")

• yahboom_tool

  Unified control for Yahboom Raspbot v2 (ROS 2 Humble). [RATIONALE] Consolidates 30+ hardware operations into a single portmanteau tool to stay within MCP tool visibility limits. Routes motion, sensors, diagnostics, trajectory, LEDs, camera PTZ, and voice commands through a single dispatch interface. ## Return Format {"success": bool, "operation": str, "result": {...}, "correlation_id": str} On error: {"success": false, "operation": str, "error": str, "correlation_id": str} ## Examples yahboom_tool(operation="health_check") yahboom_tool(operation="forward", param1=0.3) yahboom_tool(operation…

Signals

Stars

4

Forks

0

Open issues

0

Last commit

Oct 24, 2026 (4 days ago)

Last release

Aug 28, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.sandraschi/yahboom-mcp

Version

2.5.0b1

Auth

No auth

Packages

mcpb https://github.com/sandraschi/yahboom-mcp/releases/download/v2.5.0b1/yahboom-mcp-v2.5.0b1.mcpb

License

MIT

Repository

github.com/sandraschi/yahboom-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql