{ "markdown": "# RegenNexus MCP Server\r\n\r\n\"RegenNexus\r\n\r\n\r\n\r\nMCP (Model Context Protocol) server adapter for [RegenNexus UAP](https://github.com/ReGenNow/ReGenNexus) - enabling AI-controlled hardware.\r\n\r\nThis package exposes RegenNexus hardware capabilities as MCP tools, allowing Claude Code, Claude Desktop, and other MCP-compatible AI clients to control physical devices.\r\n\r\n## Features\r\n\r\n- **Hardware Control**: GPIO, PWM, robotic arms, sensors, cameras\r\n- **Mesh Networking**: Discover and communicate with nodes over LAN (UDP/WebSocket)\r\n- **Serial/I2C**: Communicate with microcontrollers and sensors\r\n- **Two Connection Modes**: Local (direct import) or Remote (HTTP API)\r\n- **Auto-Discovery**: Automatically detects installed RegenNexus and mesh nodes\r\n- **MCP Compatible**: Works with Claude, Codex, Gemini, and any MCP client\r\n\r\n## Installation\r\n\r\n```bash\r\n# MCP server only (for remote UAP connection)\r\npip install regennexus-mcp\r\n\r\n# With local UAP support\r\npip install regennexus-mcp[local]\r\n\r\n# With remote API support\r\npip install regennexus-mcp[remote]\r\n\r\n# Everything\r\npip install regennexus-mcp[all]\r\n```\r\n\r\n## Quick Start\r\n\r\n### 1. Configure Claude Code\r\n\r\nAdd to your Claude Code MCP settings:\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"regennexus\": {\r\n \"command\": \"regennexus-mcp\"\r\n }\r\n }\r\n}\r\n```\r\n\r\n### 2. Use with Claude\r\n\r\nOnce configured, Claude can control hardware:\r\n\r\n```\r\nUser: \"List all connected devices\"\r\nClaude: [calls list_devices tool]\r\n\r\nUser: \"Turn on GPIO pin 18\"\r\nClaude: [calls gpio_write with pin=18, value=1]\r\n\r\nUser: \"Move the robot arm to position [0, 45, -30, 0, 60, 0, 0]\"\r\nClaude: [calls robot_arm_move with positions]\r\n```\r\n\r\n## Configuration\r\n\r\nConfigure via environment variables:\r\n\r\n```bash\r\n# Connection mode: auto, local, or remote\r\nREGENNEXUS_MODE=auto\r\n\r\n# Remote mode settings\r\nREGENNEXUS_ENDPOINT=https://your-uap-server.com\r\nREGENNEXUS_API_KEY=your-api-key\r\n\r\n# Local mode settings\r\nREGENNEXUS_CONFIG=/path/to/regennexus-config.yaml\r\n\r\n# Logging\r\nREGENNEXUS_LOG_LEVEL=INFO\r\n```\r\n\r\n### Claude Code Config with Environment\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"regennexus\": {\r\n \"command\": \"regennexus-mcp\",\r\n \"env\": {\r\n \"REGENNEXUS_MODE\": \"local\",\r\n \"REGENNEXUS_LOG_LEVEL\": \"DEBUG\"\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n## Available Tools (Free Tier)\r\n\r\nThese tools are provided by the `regennexus` package (open source):\r\n\r\n### GPIO & Basic I/O\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `gpio_write` | Set a GPIO pin to HIGH (1) or LOW (0) |\r\n| `gpio_read` | Read the current state of a GPIO pin |\r\n| `pwm_write` | Set PWM duty cycle (0-100%) for motors, LEDs, servos |\r\n\r\n### Sensors & I2C\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `read_sensor` | Read value from a sensor (temperature, humidity, etc.) |\r\n| `i2c_scan` | Scan I2C bus for connected devices |\r\n\r\n### Serial Communication\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `serial_send` | Send data over serial port (UART) |\r\n| `serial_read` | Read data from serial port |\r\n\r\n### Robotics\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `robot_arm_move` | Move a robotic arm to specified joint positions |\r\n| `gripper_control` | Open or close a robotic gripper |\r\n\r\n### Device Management\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `list_devices` | List all connected hardware devices |\r\n| `device_info` | Get device details (CPU, memory, IP, temperature) |\r\n\r\n### Camera\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `camera_capture` | Capture a single image from a camera |\r\n\r\n### Mesh Network\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `list_nodes` | List all nodes in the mesh network |\r\n| `ping_node` | Ping a node and measure network latency |\r\n| `send_to_node` | Send a message/command to a specific node |\r\n| `broadcast_message` | Broadcast a message to all nodes |\r\n| `find_by_capability` | Find nodes with a specific capability |\r\n\r\nPremium tools with additional capabilities are available separately.\r\n\r\n## Connection Modes\r\n\r\n### Local Mode (Recommended)\r\n\r\nRequires `regennexus` package installed on the same machine. Directly imports UAP modules for minimal latency. **No API server needed.**\r\n\r\n```bash\r\npip install regennexus-mcp[local]\r\nREGENNEXUS_MODE=local regennexus-mcp\r\n```\r\n\r\nThis is the recommended mode for most users.\r\n\r\n### Remote Mode (Advanced)\r\n\r\nConnects to a UAP instance running as a service via HTTP API. Requires UAP API server to be running (`regen server`).\r\n\r\n```bash\r\n# On the UAP server machine:\r\nregen server --port 8080\r\n\r\n# On the Claude Code machine:\r\npip install regennexus-mcp[remote]\r\nREGENNEXUS_MODE=remote \\\r\nREGENNEXUS_ENDPOINT=http://uap-server:8080 \\\r\nregennexus-mcp\r\n```\r\n\r\n### Auto Mode (Default)\r\n\r\nTries local first, falls back to remote if UAP not installed.\r\n\r\n```bash\r\nregennexus-mcp # Auto-detects best mode\r\n```\r\n\r\n## Running Standalone\r\n\r\n```bash\r\n# Run MCP server\r\nregennexus-mcp\r\n\r\n# Or via Python\r\npython -m regennexus_mcp\r\n```\r\n\r\n## Architecture\r\n\r\n```\r\nClaude Code (MCP Client)\r\n │\r\n ▼\r\nregennexus-mcp (This Package)\r\n │\r\n ├── Local Mode: Direct import\r\n │ │\r\n │ ▼\r\n │ regennexus (UAP)\r\n │\r\n └── Remote Mode: HTTP API\r\n │\r\n ▼\r\n UAP Service\r\n```\r\n\r\n## Development\r\n\r\n```bash\r\n# Clone\r\ngit clone https://github.com/regennow/regennexus-mcp\r\ncd regennexus-mcp\r\n\r\n# Install dev dependencies\r\npip install -e \".[dev]\"\r\n\r\n# Run tests\r\npytest\r\n\r\n# Format code\r\nblack src/\r\nruff check src/\r\n```\r\n\r\n## Related Projects\r\n\r\n- [RegenNexus UAP](https://github.com/ReGenNow/ReGenNexus) - Universal Adapter Protocol\r\n- [MCP Specification](https://modelcontextprotocol.io/) - Model Context Protocol\r\n\r\n## License\r\n\r\nMIT License\r\n", "bytes": 5891, "sha": "aee038f1a49f5c54a59c4e2193dfb3160cfe272b1d17b8f32cc56371d401e8c9", "repo_slug": "regennow/regennexus-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_regennow_regennexus_mcp_1e6f16c3/readme" }