Skip to main content
Glama
ReGenNow

RegenNexus MCP Server

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, robotic arms, sensors, cameras

  • Two Connection Modes: Local (direct import) or Remote (HTTP API)

  • Auto-Discovery: Automatically detects installed RegenNexus

  • Claude Code Integration: Drop-in MCP server for Claude

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):

Tool

Description

gpio_write

Set a GPIO pin to HIGH (1) or LOW (0)

robot_arm_move

Move a robotic arm to specified joint positions

gripper_control

Open or close a robotic gripper

read_sensor

Read value from a sensor

list_devices

List all connected hardware devices

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ReGenNow/regennexus-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server