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