一个用于控制Reachy Mini机器人的MCP（模型上下文协议）服务器。这使得Claude Desktop及其他MCP客户端能够通过自然语言与Reachy Mini机器人交互。

特色

• 舞蹈：演奏编排好的舞蹈动作
• 情感：表达预录的情感
• 头部运动：头部向不同方向移动
• 相机：从机器人相机捕捉图像
• 头部追踪：启用面部跟踪模式
• ** 🎤 实时本地TTS**：文本转语音完全在设备上运行，支持流式音频——无云API，无延迟，无API成本
• 运动控制：停止动作并查询机器人状态

安装

配置

将 .env.example 复制到 .env 并配置：

可用的环境变量：

用途

直接运行服务器

Claude Code CLI

使用 claude mcp add 命令添加 MCP 服务器：

Reachy Mini MCP Server

An MCP (Model Context Protocol) server for controlling Reachy Mini robots. This allows Claude Desktop and other MCP clients to interact with Reachy Mini robots through natural language.

Features

• Dance: Play choreographed dance moves
• Emotions: Express pre-recorded emotions
• Head Movement: Move head in different directions
• Camera: Capture images from the robot’s camera
• Head Tracking: Enable face tracking mode
• 🎤 Real-Time Local TTS: Text-to-speech runs entirely on-device with streaming audio - no cloud APIs, no latency, no API costs
• Motion Control: Stop motions and query robot status

Installation

# Clone the repository
cd reachy-mini-mcp

# Create virtual environment
uv venv --python 3.10
source .venv/bin/activate

# Install dependencies
uv pip install -e .

# Optional: Install camera support
uv pip install -e ".[camera]"

# Optional: Install speech support (text-to-speech)
uv pip install -e ".[speech]"

Configuration

Copy .env.example to .env and configure:

cp .env.example .env

Available environment variables:

Usage

Running the server directly

reachy-mini-mcp

Claude Code CLI

Add the MCP server using the claude mcp add command:

# Build from source (after cloning the repo)
claude mcp add --transport stdio reachy-mini -- bash -c "cd /path/to/reachy-mini-mcp && uv run reachy-mini-mcp"

# With camera support enabled
claude mcp add --transport stdio reachy-mini --env REACHY_MINI_ENABLE_CAMERA=true -- bash -c "cd /path/to/reachy-mini-mcp && uv run reachy-mini-mcp"

# With custom robot name
claude mcp add --transport stdio reachy-mini --env REACHY_MINI_ROBOT_NAME=my-robot -- bash -c "cd /path/to/reachy-mini-mcp && uv run reachy-mini-mcp"

Claude Desktop Integration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reachy-mini": {
      "command": "reachy-mini-mcp",
      "env": {
        "REACHY_MINI_ENABLE_CAMERA": "true"
      }
    }
  }
}

If using a virtual environment:

{
  "mcpServers": {
    "reachy-mini": {
      "command": "/path/to/reachy-mini-mcp/.venv/bin/reachy-mini-mcp",
      "env": {
        "REACHY_MINI_ENABLE_CAMERA": "true"
      }
    }
  }
}

Available Tools

dance

Play a dance move on the robot.

Parameters:

• move (string, optional): Dance name or “random”. Default: “random”
• repeat (integer, optional): Number of times to repeat. Default: 1