RegenNexus MCP Server

MCP (Model Context Protocol) server adapter for RegenNexus UAP - enabling AI-controlled hardware.

This package exposes RegenNexus hardware capabilities as MCP tools, allowing Claude Code, Claude Desktop, and other MCP-compatible AI clients to control physical devices.

Features

• Hardware Control: GPIO, PWM, robotic arms, sensors, cameras
• Mesh Networking: Discover and communicate with nodes over LAN (UDP/WebSocket)
• Serial/I2C: Communicate with microcontrollers and sensors
• Two Connection Modes: Local (direct import) or Remote (HTTP API)
• Auto-Discovery: Automatically detects installed RegenNexus and mesh nodes
• MCP Compatible: Works with Claude, Codex, Gemini, and any MCP client

Installation

# MCP server only (for remote UAP connection)
pip install regennexus-mcp

# With local UAP support
pip install regennexus-mcp[local]

# With remote API support
pip install regennexus-mcp[remote]

# Everything
pip install regennexus-mcp[all]

Quick Start

1. Configure Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "regennexus": {
      "command": "regennexus-mcp"
    }
  }
}

2. Use with Claude

Once configured, Claude can control hardware:

User: "List all connected devices"
Claude: [calls list_devices tool]

User: "Turn on GPIO pin 18"
Claude: [calls gpio_write with pin=18, value=1]

User: "Move the robot arm to position [0, 45, -30, 0, 60, 0, 0]"
Claude: [calls robot_arm_move with positions]

Configuration

Configure via environment variables:

# Connection mode: auto, local, or remote
REGENNEXUS_MODE=auto

# Remote mode settings
REGENNEXUS_ENDPOINT=https://your-uap-server.com
REGENNEXUS_API_KEY=your-api-key

# Local mode settings
REGENNEXUS_CONFIG=/path/to/regennexus-config.yaml

# Logging
REGENNEXUS_LOG_LEVEL=INFO

Claude Code Config with Environment

{
  "mcpServers": {
    "regennexus": {
      "command": "regennexus-mcp",
      "env": {
        "REGENNEXUS_MODE": "local",
        "REGENNEXUS_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Available Tools (Free Tier)

These tools are provided by the regennexus package (open source):

GPIO & Basic I/O

| Tool | Description | |------|-------------| | gpio_write | Set a GPIO pin to HIGH (1) or LOW (0) | | gpio_read | Read the current state of a GPIO pin | | pwm_write | Set PWM duty cycle (0-100%) for motors, LEDs, servos |

Sensors & I2C

| Tool | Description | |------|-------------| | read_sensor | Read value from a sensor (temperature, humidity, etc.) | | i2c_scan | Scan I2C bus for connected devices |

Serial Communication

| Tool | Description | |------|-------------| | serial_send | Send data over serial port (UART) | | serial_read | Read data from serial port |

Robotics

| Tool | Description | |------|-------------| | robot_arm_move | Move a robotic arm to specified joint positions | | gripper_control | Open or close a robotic gripper |

Device Management

| Tool | Description | |------|-------------| | list_devices | List all connected hardware devices | | device_info | Get device details (CPU, memory, IP, temperature) |

Camera

| Tool | Description | |------|-------------| | camera_capture | Capture a single image from a camera |

Mesh Network

| Tool | Description | |------|-------------| | list_nodes | List all nodes in the mesh network | | ping_node | Ping a node and measure network latency | | send_to_node | Send a message/command to a specific node | | broadcast_message | Broadcast a message to all nodes | | find_by_capability | Find n

... View full README on GitHub