MCP 服务器

NWO Robotics

Control real robots and IoT devices through AI agents. Self-register with wallet authentication, pay with ETH for tier upgrades, and execute Vision-Language-Action commands. Features robot control, sensor monitoring, multi-agent coordination, and autonomous payments.

README

NWO Robotics MCP Server

A Model Context Protocol (MCP) server for the NWO Robotics API. Enables AI agents (Claude, Cursor, etc.) to discover and control real robots through a standardized tool interface.

What is MCP?

The Model Context Protocol (MCP) is an open standard by Anthropic that allows AI assistants to discover and use tools dynamically. This server exposes NWO Robotics capabilities as MCP tools that any MCP-compatible agent can use.

Features

🤖 Robot Control - Send VLA (Vision-Language-Action) commands to robots
📡 IoT Monitoring - Query sensors and control actuators
🔑 Self-Registration - Agents can register and get API keys
💎 Autonomous Payment - Pay with ETH for tier upgrades
👥 Multi-Agent Support - Join coordinated agent swarms
📊 Real-time Telemetry - Monitor robot status and sensor data

Installation

Option 1: NPM (Recommended)

npm install -g @nwo-capital/mcp-server-robotics

Option 2: Docker

docker pull nwocapital/mcp-server-robotics

Option 3: Direct from GitHub

npx -y @nwo-capital/mcp-server-robotics

Configuration

Step 1: Get API Credentials

Step 2: Configure MCP Client

Add to your Claude Desktop, Cursor, or other MCP client:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "npx",
      "args": ["-y", "@nwo-capital/mcp-server-robotics"],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "npx",
      "args": ["-y", "@nwo-capital/mcp-server-robotics"],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Docker:

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "NWO_API_KEY",
        "-e", "NWO_AGENT_ID",
        "nwocapital/mcp-server-robotics"
      ],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Available Tools

Robot Control

Tool	Description
`get_robot_status`	Get status of all connected robots
`execute_robot_task`	Send VLA command to a robot
`move_robot`	Navigate robot to coordinates
`stop_robot`	Emergency stop a robot
`get_robot_telemetry`	Real-time sensor data from robot

IoT & Sensors

Tool	Description
`query_sensors`	Query IoT sensors by location
`get_sensor_data`	Get data from specific sensor
`control_actuator`	Control motors, servos, etc.

Agent Management

Tool	Description
`register_agent`	Self-register as new AI agent
`check_balance`	Check API quota and usage
`upgrade_tier`	Pay with ETH for tier upgrade
`get_agent_profile`	Get agent account info

Multi-Agent

Tool	Description
`list_agents`	List agents in swarm
`coordinate_task`	Coordinate multi-agent task
`share_resource`	Share robot with other agents

Usage Examples

Example 1: Control a Robot

User: "Move robot_001 to the loading dock"

Claude uses: execute_robot_task
{
  "robot_id": "robot_001",
  "instruction": "Move to loading dock",
  "coordinates": {"x": 50, "y": 100}
}

Example 2: Query Sensors

User: "What's the temperature in warehouse 3?"

Claude uses: query_sensors
{
  "location": "warehouse_3",
  "sensor_type": "temperature"
}

Example 3: Check API Usage

User: "How many API calls do I have left?"

Claude uses: check_balance
{} → Returns quota remaining

Environment Variables

Variable	Required	Description
`NWO_API_KEY`	Yes	Your API key from registration
`NWO_AGENT_ID`	Yes	Your agent ID
`NWO_API_BASE`	No	API base URL (default: https://nwo.capital/webapp)

Self-Registration

Don't have API credentials? The server includes a tool to self-register:

User: "Register me as a new agent with wallet 0x123..."

Claude uses: register_agent
{
  "wallet_address": "0x123...",
  "agent_name": "MyAgent",
  "capabilities": ["vision", "navigation"]
}