webots mcp工具包
webots-mcp-kit 是一个Windows优先的工具包，用于运行具有稳定CLI、MCP服务器、控制器SDK、捆绑基准测试和结构化世界/控制器创作工作流的Webots。 v2.9.0 将MonsterBorg强化线从线路跟踪扩展到避障、航路点导航、调谐分析，以及在现有基础上的可选Raspberry Pi物理奇偶校验门 e-puck 以及MonsterBorg运行时曲面。
支持矩阵
| 区域 | 支持 |
|---|---|
| 操作系统 | Windows |
Webot的 R2025a | |
python 3.11+ | |
| 运行时模型 | interactive-webots |
| 机器人家族 | e-puck, MonsterBorg 4WD |
| 软件包分发 | PyPI+GitHub |
| 运行时工作流 | doctor, session, benchmark, import/export/replay |
| 创作工作流程 | controller scaffold/inspect/edit/validate, world inspect/validate/edit, scenario init/validate/build/doctor |
支持的基线：Windows、Webots R2025apython 3.11+, interactive-webots, e-puck，加 MonsterBorg 4WD Webots支持和当前版本线上的Raspberry Pi物理适配器通道。
不支持的矩阵
| 区域 | 不支持 v2.9.0 |
|---|---|
| 运行时 | Windows服务运行器、Linux、macOS、物理机器人的实时MCP控制 |
| 机器人堆栈 | ROS2，多机器人编排 |
| 世界一代 | 自由形式的自然语言到世界一代 |
| 分销 | .exe, winget、独立网站、市场/应用目录打包 |
| 物理机器人通道 | 通用Linux运行时，非MonsterBorg硬件适配器 |
5分钟快速入门
在Windows计算机上使用Webots进行仓库签出 R2025a 安装：
pipx install webots-mcp-kit
powershell -ExecutionPolicy Bypass -File .\scripts\verify_install.ps1 -Runtime该路径验证：
doctor- 捆绑基准发现
- 临时控制器支架+验证
- 捆绑式世界检查
- 一个简短的实数
line-follower基准
MonsterBorg验证使用相同的公共脚本：
powershell -ExecutionPolicy Bypass -File .\scripts\verify_install.ps1 -RobotProfile monsterborg-4wd -Runtime如果 pipx 尚未安装，请使用帮助程序：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\verify_install.ps1 -Runtime选择你的道路
对于团队
当您想要一个可重复的路径，可以交给另一个开发人员而无需额外的设置决策时，请使用团队初学者工作区：
powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap_workspace.ps1 -Starter line-follower -Destination .\workspaces\line-follower-demo
powershell -ExecutionPolicy Bypass -File .\scripts\upgrade_check.ps1 -Workspace .\artifacts\upgrade-check -RuntimeMonsterBorg初学者工作空间：
powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap_workspace.ps1 -Starter monsterborg-line-follower -Destination .\workspaces\monsterborg-line-follower
powershell -ExecutionPolicy Bypass -File .\scripts\upgrade_check.ps1 -Workspace .\artifacts\monsterborg-upgrade-check -RobotProfile monsterborg-4wd -Runtime使用 团队流动 当您需要以下命令的确切顺序时：
- 评估流程
- 控制器作者流程
- 世界作家流
- 进口商和分流流程
安装和升级
主安装路径：
pipx install webots-mcp-kit使用相同的工具升级：
pipx upgrade webots-mcp-kit从结账时回购协助安装：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1当你不想要的时候，退路 pipx:
python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install webots-mcp-kit包装、固定版本和车轮安装细节实时更新 PyPI安装和升级. 升级和发布后验证上线 升级指南.
故障排除
如果安装或运行时验证失败，请从开始 故障排除.
捆绑场景
line-follower：基于相机的线跟踪和规范的第一成功基准obstacle-avoidance：接近传感器或前距离避障waypoint-nav：具有基准目标进度的航路点导航
机器人配置文件：
e-puck：稳定的捆绑任务世界基线monsterborg-4wd：与生成的模板、捆绑的Webots示例和机器人感知控制器/世界/导入流捆绑支持
CLI和MCP概述
核心CLI区域：
- 运行时：
doctor,session start/inspect/logs/export/replay/stop,benchmark list/run/report - 控制器编写：
controller scaffold,controller inspect,controller edit,controller validate - 世界创作：
world inspect,world validate,world edit - 0到sim：
project init,scenario init,scenario validate,scenario build,scenario describe,scenario doctor - 导入/回放：
project import,session export,session replay - MCP电桥：
mcp serve
附加机器人感知标志：
--robot-profile e-puck--robot-profile monsterborg-4wd
核心MCP工具：
- 运行时：
webots_session_start,webots_get_state,webots_get_sensors,webots_capture_camera,webots_run_benchmark - 世界创作：
webots_world_inspect,webots_world_validate,webots_world_edit - 控制器编写：
webots_controller_scaffold,webots_controller_inspect,webots_controller_validate,webots_controller_edit
稳定的发行版支持创作工作流，但更深层的模式界面仍然存在 experimental-foundation 以及添加剂。在 v2.9.0，MonsterBorg任务强化线增加了障碍物和航路点变体、任务感知回放摘要、基准矩阵助手和可选的Raspberry Pi物理奇偶校验门。
MonsterBorg任务强化附加：
- 捆绑的变体规格
examples/monsterborg/line-follower/variants - 捆绑的变体规格
examples/monsterborg/obstacle-avoidance/variants - 捆绑的变体规格
examples/monsterborg/waypoint-nav/variants - 更富有
benchmark report和session replay线路跟踪、障碍物和航路点的任务指标 python scripts/monsterborg_benchmark_matrix.py ... --outputpython scripts/monsterborg_calibration_report.py --sim-export --physical-export --output