Regennexus Mcp

io.github.ReGenNowPublished by GitHub account ReGenNowv0.1.1Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

Local MCP server that lets an AI assistant control physical hardware — GPIO pins, sensors, cameras, robotic arms and mesh nodes — through RegenNexus UAP.

What you can do
Set and read GPIO pins and PWM duty cycles for motors, LEDs and servos, and read sensor values or scan the I2C bus. Send and read data over serial (UART) ports. Move a robotic arm to joint positions and open or close a gripper. Capture a single image from a camera. List connected devices and get device details such as CPU, memory, IP and temperature. Discover mesh nodes, ping them, send or broadcast messages, and find nodes by capability.
When to use it
Use it when you want an assistant to drive real hardware on or near the machine — toggling pins, reading sensors, moving a robot arm, taking a camera snapshot, or talking to mesh nodes over the LAN. It suits hobbyist, lab and prototyping setups rather than software-only work.
Requirements
Runs as a local Python process installed from PyPI (regennexus-mcp). Local mode needs the regennexus package on the same machine; remote mode needs a running UAP API server and the REGENNEXUS_ENDPOINT and REGENNEXUS_API_KEY settings. REGENNEXUS_MODE selects auto, local or remote; REGENNEXUS_CONFIG and REGENNEXUS_LOG_LEVEL are optional. Desktop only.
Before you install
The assistant can physically actuate hardware: GPIO writes, PWM output, robot arm and gripper movement, serial sends and mesh broadcasts all change the real world and may be unsafe around people or equipment. Remote mode sends commands to a UAP server and needs REGENNEXUS_API_KEY. Some tools are free tier only; premium capabilities are sold separately.

Installation

In SourceWeft

  1. Open Regennexus Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

RegenNexus MCP Server

[RegenNexus Logo]

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

bash
# 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:

json
{
  "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:

bash
# 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

json
{
  "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

Local Mode (Recommended)

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

bash
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).

bash
# 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.

bash
regennexus-mcp  # Auto-detects best mode

Running Standalone

bash
# 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

bash
# 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/

Related Projects

License

MIT License

Source: README.md at commit 510e35d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts