io.github.ReGenNow/regennexus-mcp

Official registry AI and agents

AI-controlled hardware: GPIO, robotics, sensors, cameras, mesh networking for IoT

What can you do with io.github.ReGenNow/regennexus-mcp?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package regennexus-mcp
Claude Code
claude mcp add regennexus-mcp -e 'REGENNEXUS_MODE=<REGENNEXUS_MODE>' -- python regennexus-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "regennexus-mcp": {
            "command": "python",
            "args": [
                "regennexus-mcp==0.1.1"
            ],
            "env": {
                "REGENNEXUS_MODE": "<REGENNEXUS_MODE>"
            }
        }
    }
}

Environment variables

  • REGENNEXUS_MODE Connection mode: auto, local, or remote

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. RegenNexus MCP Server
  2. Features
  3. Installation
  4. Quick Start
  5. Configuration
  6. Available Tools (Free Tier)
  7. Connection Modes
  8. Running Standalone
  9. Architecture
  10. Development
  11. Related Projects
  12. License

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
ToolDescription
gpio_writeSet a GPIO pin to HIGH (1) or LOW (0)
gpio_readRead the current state of a GPIO pin
pwm_writeSet PWM duty cycle (0-100%) for motors, LEDs, servos
Sensors & I2C
ToolDescription
read_sensorRead value from a sensor (temperature, humidity, etc.)
i2c_scanScan I2C bus for connected devices
Serial Communication
ToolDescription
serial_sendSend data over serial port (UART)
serial_readRead data from serial port
Robotics
ToolDescription
robot_arm_moveMove a robotic arm to specified joint positions
gripper_controlOpen or close a robotic gripper
Device Management
ToolDescription
list_devicesList all connected hardware devices
device_infoGet device details (CPU, memory, IP, temperature)
Camera
ToolDescription
camera_captureCapture a single image from a camera
Mesh Network
ToolDescription
list_nodesList all nodes in the mesh network
ping_nodePing a node and measure network latency
send_to_nodeSend a message/command to a specific node
broadcast_messageBroadcast a message to all nodes
find_by_capabilityFind nodes with a specific capability

Premium tools with additional capabilities are available separately.

Connection Modes

Requires regennexus package installed on the same machine. Directly imports UAP modules for minimal latency. No API server needed.

pip install regennexus-mcp[local]
REGENNEXUS_MODE=local regennexus-mcp

This is the recommended mode for most users.

Remote Mode (Advanced)

Connects to a UAP instance running as a service via HTTP API. Requires UAP API server to be running (regen server).

# On the UAP server machine:
regen server --port 8080

# On the Claude Code machine:
pip install regennexus-mcp[remote]
REGENNEXUS_MODE=remote \
REGENNEXUS_ENDPOINT=http://uap-server:8080 \
regennexus-mcp
Auto Mode (Default)

Tries local first, falls back to remote if UAP not installed.

regennexus-mcp  # Auto-detects best mode

Running Standalone

# Run MCP server
regennexus-mcp

# Or via Python
python -m regennexus_mcp

Architecture

Claude Code (MCP Client)
        │
        ▼
regennexus-mcp (This Package)
        │
        ├── Local Mode: Direct import
        │       │
        │       ▼
        │   regennexus (UAP)
        │
        └── Remote Mode: HTTP API
                │
                ▼
            UAP Service

Development

# Clone
git clone https://github.com/regennow/regennexus-mcp
cd regennexus-mcp

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
ruff check src/

License

MIT License

Frequently asked questions

What is io.github.ReGenNow/regennexus-mcp?

AI-controlled hardware: GPIO, robotics, sensors, cameras, mesh networking for IoT

How do I install io.github.ReGenNow/regennexus-mcp?

It runs on your machine. In Claude Code: claude mcp add regennexus-mcp -e 'REGENNEXUS_MODE=<REGENNEXUS_MODE>' -- python regennexus-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ReGenNow/regennexus-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ReGenNow/regennexus-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ReGenNow/regennexus-mcp?

It is published by ReGenNow. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.