# mcp-openduck

**Repository Path**: ncnynl/mcp-openduck

## Basic Information

- **Project Name**: mcp-openduck
- **Description**: 机械鸭的MCP服务，通过小智实现语音控制机械鸭
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-03
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP For OpenDuckMini Project 

## 项目简介 | Project Overview
**MCP (Mini Controller Protocol)** 是为 **OpenDuckMini** 项目设计的多功能控制协议与工具库。  
它支持通过 **WebSocket** 与 OpenDuckMini 机械鸭进行实时交互，提供：
- MCP 外部控制支持  
- 动作命令实时发送与状态同步  
- 简化的仿真测试与真机控制接口  

该项目适合教育、研发以及快速原型开发场景。

---

## 作者信息 | Authors
- **主作者 / Maintainer**: ncnynl
- **团队 / Organization**: 爱折腾 (AZT Robotics)  
- **邮箱 / Email**: 1043931@qq.com  
- **资料站 / Website**:[https://www.ncnynl.com/category/OpenDuckMini/](https://www.ncnynl.com/category/OpenDuckMini/)
- **GitHub / 开源地址**: [https://gitee.com/ncnynl/mcp-openduck](https://gitee.com/ncnynl/mcp-openduck)


## Quick Start | 快速开始

1. Install dependencies | 安装依赖:
```bash
pip install -r requirements.txt
```

2. Set up environment variables | 设置环境变量: <your_mcp_endpoint> 从小智语音https://xiaozhi.me/获取MCP接入点地址
```bash
export MCP_ENDPOINT=<your_mcp_endpoint>

#build mcp_point.sh, put export MCP_ENDPOINT=<your_mcp_endpoint> into it , modify <your_mcp_endpoint> for your's
cp mcp_point_example.sh mcp_point.sh
vim mcp_point.sh 

# use it
source ./mcp_point.sh
```

3. Run the openduck  | 运行计算器示例:
```bash
./start.sh
```

4. Test the mcp_controller controller separately/ 单独测试用例单独测试mcp_controller控制器

```bash
python3 test_openduck.py
```

## 与Open_Duck整合

1. 复制控制器mcp_contrlloer.py

```
#复制控制器mcp_contrlloer.py到Open_Duck_Mini_Runtime目录下,与xbox_controller.py一起
cp ~/open_duck_mini_ws/mcp-openduck/mini_bdx_runtime/mcp_controller.py ~/open_duck_mini_ws/Open_Duck_Mini_Runtime/mini_bdx_runtime/mini_bdx_runtime/
```

2. 复制控制器v2_rl_walk_mujoco_mcp.py 
```
#复制控制器mcp_contrlloer.py到Open_Duck_Mini_Runtime目录下,与xbox_controller.py一起
cp  ~/open_duck_mini_ws/mcp-openduck/v2_rl_walk_mujoco_mcp.py  ~/open_duck_mini_ws/Open_Duck_Mini_Runtime/scripts
```


3. Run openduck with mcp-openduck

```
#run mcp-openduck
cd ~/open_duck_mini_ws/mcp-openduck
./start.sh 

#run v2_rl_walk_mujoco_mcp.py
cd ~/open_duck_mini_ws/Open_Duck_Mini_Runtime/scripts/
python v2_rl_walk_mujoco_mcp.py --mcp --onnx_model_path ~/open_duck_mini_ws/Open_Duck_Mini/BEST_WALK_ONNX_2.onnx
```
4. 通过小智语音控制

- 1.目前使用实战派esp32-s3刷小智固件V1.8.8版本测试
- 2.配置好实战派能正常语音交互，再为mcp-openduck设置好mcp接入点, 查看2.设置环境变量
- 3.使用语音
```
让openduck向前两步
让openduck后退两步
让openduck左移一点
让openduck右移一点
让openduck左转一圈
让openduck右转一圈
让openduck动下左耳朵
让openduck动下右耳朵
让openduck叫一声
```

## Requirements | 环境要求

- Python 3.7+
- websockets>=11.0.3
- python-dotenv>=1.0.0
- mcp>=1.8.1
- pydantic>=2.11.4
- mcp-proxy>=0.8.2

## Contributing | 贡献指南

Contributions are welcome! Please feel free to submit a Pull Request.

欢迎贡献代码！请随时提交Pull Request。

## License | 许可证

This project is licensed under the MIT License - see the LICENSE file for details.

本项目采用MIT许可证 - 详情请查看LICENSE文件。

## Acknowledgments | 致谢

- Thanks to all contributors who have helped shape this project | 感谢所有帮助塑造这个项目的贡献者
- Inspired by the need for extensible AI capabilities | 灵感来源于对可扩展AI能力的需求