NWO机器人MCP服务器v2.0
用于NWO Robotics API的完整模型上下文协议（MCP）服务器，包含77个集成工具，涵盖SLAM、强化学习、高级传感器和完整的机器人系统控制。
 ](https://nodejs.org/)  
📋 概述
该MCP服务器通过一个统一的接口提供对所有NWO Robotics API端点的全面访问，该接口具有按优先级和功能组织的77个工具。
✨ 主要特点
- 77集成工具 -全面覆盖API
- SLAM和本地化 -持续的机器人地图和导航
- 强化学习 -云强化学习培训（PPO、SAC、DDPG、TD3）
- 高级传感器 -热、毫米波、气体、声学、磁性
- 视觉与接地 -开放词汇对象检测
- 触觉传感 -ORCA Hand 576税务反馈
- 运动规划 -MoveIt2集成防撞功能
- 任务规划 -基于行为树的分层任务执行
- ROS2集成 -用于真实机器人的云桥（UR5e、Panda、Spot）
- 安全监控 -实时安全验证和紧急停止
- MQTT物联网 -1000多个代理支持边缘计算
- 自主代理 -自我注册和基于ETH的支付
🚀 快速开始
1.克隆存储库
git clone https://github.com/RedCiprianPater/mcp-server-robotics.git
cd mcp-server-robotics2.安装依赖项
npm install3.设置环境
cp .env.example .env
# Edit .env and add your NWO_API_KEY
nano .env4.构建和运行
npm run build
npm start5.实际测试
# The server will start and display available tools
# You can now use any of the 77 tools through Claude📦 包含什么
文件
- src/index.ts -完成MCP服务器实施（77个工具）
- package.json -依赖关系和构建脚本
- Tsconflict.儿子 -TypeScript配置
- Dockerfile -容器部署
- docker-compose.yml -使用MQTT代理的全栈
- .env.示例 -环境变量模板
- 集成_指南.md -详细的集成说明
- README.md -此文件
工具类别
优先级1-独特功能（5个工具）
✅ nwo_initialize_slam - Persistent robot mapping
✅ nwo_localize - Landmark-based localization
✅ nwo_create_rl_env - Cloud RL training environments
✅ nwo_train_policy - Policy training (SB3)
✅ nwo_detect_objects_grounding - Open-vocabulary detection优先级2-新型传感器（5种工具）
✅ nwo_query_thermal - Heat detection
✅ nwo_query_mmwave - Millimeter-wave radar
✅ nwo_query_gas - Air quality sensors
✅ nwo_query_acoustic - Sound localization
✅ nwo_query_magnetic - Metal detection优先级3-高级功能（4个工具）
✅ nwo_read_tactile - ORCA Hand 576 taxels
✅ nwo_identify_material - Material recognition
✅ nwo_plan_motion - MoveIt2 motion planning
✅ nwo_execute_behavior_tree - Hierarchical task execution标准操作（58个工具）
Inference & Models (6) Robot Control (3)
Task Planning & Learning (4) Agent Management (3)
Voice & Gesture (2) Simulation & Physics (3)
ROS2 & Hardware (3) MQTT & IoT (2)
Safety & Monitoring (3) Embodiment & Calibration (3)
Autonomous Agents (4) Dataset & Export (2)
Demo & Testing (2)🔧 配置
API密钥
从获取您的免费API密钥https://nwo.capital/webapp/api-key.php
export NWO_API_KEY="sk_live_your_key_here"API终点
# Standard API (full features)
NWO_API_BASE=https://nwo.capital/webapp/api-key.php
# Edge API (ultra-low latency, 200+ locations)
NWO_EDGE_API=https://nwo-robotics-api-edge.ciprianpater.workers.dev/api
# ROS2 Bridge (for physical robots)
NWO_ROS2_BRIDGE=https://nwo-ros2-bridge.onrender.com
# MQTT Broker (IoT sensors)
MQTT_BROKER=mqtt.nwo.capital
MQTT_PORT=8883📖 使用示例
示例1：SLAM和导航
// Initialize SLAM mapping
const slam = await client.messages.create({
tools: [{name: "nwo_initialize_slam", input: {
agent_id: "robot_001",
map_name: "warehouse",
slam_type: "hybrid",
loop_closure: true
}}]
});
// Later: Localize in the map
const localize = await client.messages.create({
tools: [{name: "nwo_localize", input: {
agent_id: "robot_001",
map_id: "map_123",
image: "base64_encoded_image"
}}]
});示例2：基于视觉的任务
// Detect objects with natural language
const detect = await client.messages.create({
tools: [{name: "nwo_detect_objects_grounding", input: {
agent_id: "robot_001",
image: "base64_image",
object_description: "red cylinder on the left",
threshold: 0.85,
return_mask: true
}}]
});
// Execute action based on detection
const execute = await client.messages.create({
tools: [{name: "nwo_inference", input: {
instruction: "Pick up the detected object",
images: ["base64_image"]
}}]
});示例3：复杂任务规划
// Break down high-level instruction
const plan = await client.messages.create({
tools: [{name: "nwo_task_planner", input: {
instruction: "Clean the warehouse floor",
agent_id: "robot_001",
context: {
location: "warehouse",
known_objects: ["shelves", "boxes"]
}
}}]
});
// Execute subtasks
for (let i = 1; i > .gitignore
echo ".env" >> .gitignore
# Use environment variables or .env (in .gitignore)速率限制
- 免费层：100000个电话/月
- 原型：每月50万次通话（约16666次/天）
- 生产：无限通话
监控使用情况：
const balance = await client.messages.create({
tools: [{name: "nwo_agent_check_balance", input: {
agent_id: "agent_123"
}}]
});安全特性
- 实时碰撞检测
- 人体接近警告（默认1.5米）
- 紧急停止（响应时间\ logs/server.log 2>&1
### 指标
Monitor API usage
nwo_agent_check_balance
Export dataset for analysis
nwo_export_dataset
Check system health
GET /health (if enabled)
## 🎯 下一步
1. ✅ **设置**: `npm install && npm run build`
1. ✅ **配置**：添加 `NWO_API_KEY` 到 `.env`
1. ✅ **测试**: `npm start` 并验证工具负载
1. ✅ **整合**：与Claude API或您的框架一起使用
1. ✅ **部署**：Docker Compose或Kubernetes
1. ✅ **监视器**：检查日志和使用指标
1. ✅ **规模**：根据需要升级层
## 📞 支持
- **问题**: https://github.com/RedCiprianPater/mcp-server-robotics/issues
- **讨论**: https://github.com/RedCiprianPater/mcp-server-robotics/discussions
- **API密钥帮助**: https://nwo.capital/webapp/api-key.php
- **NWO文件**: https://nwo.capital/nwo-robotics.html
## 📝 版本历史
### v2.0.0（当前版本-2026年4月）
- ✅ 共实施77个工具
- ✅ 优先级1：SLAM、RL、接地（5）
- ✅ 优先事项2：先进传感器（5）
- ✅ 优先级3：高级功能（4）
- ✅ 标准操作（58）
- ✅ 完全支持TypeScript
- ✅ Docker和Kubernetes就绪
- ✅ 生产级错误处理
- ✅ 全面测试覆盖
### v1.0.0（上一个）
- 基本工具组（20个工具）
- 仅限标准推理
- 手动配置
## 📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件
## 🙏 致谢
- **NWO机器人** -API和基础设施
- **Anthropic** -克劳德和MCP协议
- **开源社区** -贡献和反馈
______________________________________________________________________
**最后更新**2026年4月\
**状态**: ✅ 生产就绪\
**维护者**: [@RedCiprianPater](https://github.com/RedCiprianPater)
### ⭐ 如果你觉得这很有用，请在存储库中加星！
______________________________________________________________________
## 🔗 相关项目
- [NWO机器人API](https://nwo.capital/)
- [小米机器人0](https://huggingface.co/XiaomiRobotics/Xiaomi-Robotics-0)
- [MCP协议](https://modelcontextprotocol.io/)
- [Anthropic Claude](https://www.anthropic.com/)