AI导哈

机器人HTTP控制服务器

一个用于通过HTTP API控制Reachy Mini Wireless机器人的MCP服务器，提供健康状态检查、运动控制和情感表达等功能。

  • by tychop
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 tychop/reachy-mini-http-mcp

使用说明

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",
				"<path to reachy-mini-http-mcp>/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社区让每个人都能使用机器人。

了解更多 reachy-mini.org 或 pollen-robotics.com/reachy-mini.

相关 MCP