为 Reachy Mini 添加 MCP 工具

TL;DR · AI 摘要
Hugging Face 推出 MCP 工具集成,使 Reachy Mini 机器人可通过 MCP 协议调用 Hugging Face Spaces 上的远程工具,如天气查询和网页搜索,无需修改本地应用代码,工具在云端运行,支持用户自定义发布工具,只需一条命令即可添加新能力,如询问巴黎今日天气。
核心要点
- 通过一条命令即可添加 MCP 工具:`reachy-mini-conversation-app tool-spaces add pollen-robotics/
- 工具由 Hugging Face Spaces 提供,用户可发布自己的工具供他人使用,支持机器人具备天气查询、网页搜索等新能力。
- MCP 工具与内置工具共存,保留本地工具的安全性,同时扩展了可发布的远程工具类型,适用于搜索、天气等无状态功能。
结构提纲
按章节快速跳转。
Introduces how MCP tools allow Reachy Mini to use remote tools from Hugging Face Spaces without modifying the app.
Lists local tools like move_head, dance, play_emotion, and camera, which are shipped inside the app and controlled by profiles.
Explains that tools must be enabled in a profile folder via tools.txt, with default profile enabling all built-in tools.
Discusses how local Python tools restrict sharing, updating, and modifying capabilities like web search or weather.
Introduces remote tools hosted in Hugging Face Spaces, enabling easier sharing and updating of capabilities like search and weather.
思维导图
用一张图看清主题之间的关系。
查看大纲文本(无障碍 / 无 JS 友好)
- MCP Tools for Reachy Mini
- Built-in Tools
- move_head / dance / play_emotion / camera
- Profiles Control Tools
- tools.txt enables/disables tools
- Remote Tools from Spaces
- pollen-robotics/reachy-mini-weather-tool / search-tool
金句 / Highlights
值得收藏与分享的关键句。
You can give your robot a new ability, like checking the weather or searching the web, by adding a Space from the Hub instead of editing the app. The tool keeps running in the Space itself, so no code
A tool is something the model can do during a conversation: play an emotion, move the head, look through the camera. Each tool has a name and a short description. The model reads those, decides when o
Remote tools add a third kind, alongside the built-in and custom local tools you already have, for capabilities that are easier to publish, share, and update on their own: built-in robot tools stay lo
#
安装 + 启用活跃配置文件
reachy-mini-conversation-app tool-spaces add <owner/space-name>
在特定配置文件中启用
reachy-mini-conversation-app tool-spaces add <owner/space-name> --profile <NAME>
只安装不启用
reachy-mini-conversation-app tool-spaces add <owner/space-name> --install-only
列出已安装的空间
reachy-mini-conversation-app tool-spaces list
移除已安装的空间
reachy-mini-conversation-app tool-spaces remove <owner/space-name>
add 验证 Hub 上的空间,探测 MCP 端点,发现其工具,并且默认将工具 ID 添加到活跃配置文件的 tools.txt。活跃配置文件是 default,除非你设置了 REACHY_MINI_CUSTOM_PROFILE。使用 --install-only 跳过这一步。
tools.txt是看门狗:远程工具只有在它的 ID 出现在配置文件的tools.txt中并且与你想导入的内置工具一起时才处于活动状态。
安装位置
已安装的来源保存在:
- 管理模式下为
installed_tool_spaces.json - 终端模式下为
external_content/installed_tool_spaces.json
工具命名
每个已安装的空间会得到一个从其 slug 导出的本地别名,其中连字符、句号和斜杠被转换为下划线:
pollen-robotics/reachy-mini-search-tool → pollen_robots_reachy_mini_search_tool
``
远程工具然后以双重下划线命名空间:
pollen_robots_reachy_mini_search_tool__search_web pollen_robots_reachy_mini_weather_tool__get_day_brief ``
实现存放在:
installed_tool_spaces.json(管理应用模式)external_content/installed_tool_spaces.json(终端模式)
已安装空间的别名
每个已安装 的 Space 会得到一个基于
然后