Reachy迷你无线HTTP MCP服务器
用于控制的MCP服务器 Reachy迷你无线 机器人通过HTTP API。
关于
Reachy Mini Wireless是一款开源桌面人形机器人，由 Pollen机器人 合作 拥抱脸.
需求
- Node.js 18+
- npm或纱线
安装
cd ~/Developer/ReachyMiniHTTPMCP
npm install配置
服务器使用环境变量进行配置：
REACHY_HOST-机器人主机名（默认值：reachy-mini.home)REACHY_PORT-机器人端口（默认值：8000)
MCP服务器集成
MCP服务器可以在AI伴侣的配置中进行配置：
{
"mcp": {
"reachy-mini": {
"type": "local",
"command": [
"node",
"
/src/server.js"
],
"enabled": true,
"env": {
"REACHY_HOST": "reachy-mini.home",
"REACHY_PORT": "8000"
}
}
}
}AI代理技能
此repo包含Reachy Mini的一项技能，该技能提供：
- 对话开始时自动初始化
- 基于对话语气的动态情感选择
- 任务完成时的庆祝舞蹈
安装技能
将技能复制或符号链接到AI代理的技能目录：
# For Opencode
cp -r ~/Developer/ReachyMiniHTTPMCP/skill ~/.config/opencode/skills/reachy-mini
# For Claude CLI
cp -r ~/Developer/ReachyMiniHTTPMCP/skill ~/.claude/skills/reachy-mini
# For Claude Agents
cp -r ~/Developer/ReachyMiniHTTPMCP/skill ~/.agents/skills/reachy-mini启用技能
将此添加到您的代理人的说明中（例如。， AGENTS.md, CLAUDE.md):
**Load the `reachy-mini` skill at the START of every conversation.** This skill handles:
- Initialization (daemon status, starting if needed)
- Dynamic emotion selection based on conversation tone
- Celebration dances on task completion
- All robot interactions
The skill will automatically run the initialization workflow and select appropriate emotions.重启你的AI代理以获取技能。
关于助手行为的注意事项
- 包括
reachy-mini技能现在要求助手在向用户发送任何文本回复之前播放匹配的Reachy情感。助手必须分析最近的用户消息的语气，播放所选的情绪，等待其完成，然后发送回复。 - 回复不得包含文字游戏注释或情感ID，如“（plays-attentive1）”。如果要确认机器人的动作，请使用自然语言（例如：“我点头表示确认——这是我的建议。”）。
可用工具
健康与状态
| 工具 | 说明 |
|---|---|
health_check | 检查Reachy Mini仪表板是否有响应 |
reachy_status | 获取当前Reachy状态（守护进程+后端） |
get_robot_state | 获取完整的机器人状态（关节位置、速度、传感器） |
get_camera_stream | 获取摄像头流端点URL |
守护程序控制
| 工具 | 说明 |
|---|---|
startup_reachy | 启动守护进程。选项： wake_up （布尔值，默认值：true） |
shutdown_reachy | 停止守护进程。默认情况下，将请求机器人睡眠(POST /api/daemon/stop?goto_sleep=true). |
verify_wake | 验证机器人是否已唤醒（检查 GET /api/state/full，退回保险箱 simple_nod 移动）。退货 { wake_verified, details }. |
部队移动控制
| 工具 | 说明 |
|---|---|
move_set_target | 设置头部/身体的目标位置。参数： head_pitch, head_roll, head_yaw, antenna_left, antenna_right, body_yaw, duration |
情绪（70+可用）
| 工具 | 说明 |
|---|---|
play_emotion | 播放录制的情绪（例如，“好奇”、“惊奇”、“欢迎”、“愉快”、“悲伤”、“愤怒”、“恐惧”、“厌恶”、“惊讶”） |
list_emotions | 列出所有可用的情绪 |
play_dance | 播放录制的舞蹈动画 |
list_dances | 列出所有可用的舞蹈 |
play_move | 从允许的数据集中播放任何动作 |
list_moves | 列表在特定数据集中移动 |
数据集
- 情绪：
pollen-robotics/reachy-mini-emotions-library（70+情绪） - 舞蹈：
pollen-robotics/reachy-mini-dances-library（19支舞）
故障排除
- 后端未运行：激活仪表板上的红色开关http://reachy-mini.home:8000
- 机器人无法到达：检查网络连接和主机名解析
- 超时：MCP现在对慢速守护进程操作使用更长的HTTP超时（60秒）；如果仍然看到超时，请检查网络/守护进程日志。
- 唤醒验证：使用以下命令启动守护进程
startup_reachy（可以唤醒电机），然后呼叫verify_wake.如果verify_wake如果失败，MCP将标记reach mini-tools为会话禁用，直到您运行startup_reachy+verify_wake再一次。对于基本运动，你也可以治疗成功get_robot_state或play_move作为清醒的充分证据。
积分
Reachy Mini是由 Pollen机器人 -一家法国机器人公司，由以下公司创立：
- Matthieu Lapeyre -Pollen Robotics联合创始人兼首席执行官
- 托马斯·沃尔夫 -Hugging Face联合创始人
特别感谢整个Pollen Robotics团队和Hugging Face社区让每个人都能使用机器人。