regennexus-mcp

RegenNexus MCP 服务

RegenNexus UAP 的 MCP（Model Context Protocol）服务适配器，可实现由 AI 控制硬件。

此软件包将 RegenNexus 硬件功能作为 MCP 工具提供，使 Claude Code、Claude Desktop 和其他兼容 MCP 的 AI 客户端能够控制物理设备。

功能

• 硬件控制：GPIO、PWM、机械臂、传感器、摄像头
• 网状网络：通过 LAN（UDP/WebSocket）发现节点并与之通信
• 串口/I2C：与微控制器和传感器通信
• 两种连接模式：本地（直接导入）或远程（HTTP API）
• 自动发现：自动检测已安装的 RegenNexus 和网状网络节点
• 兼容 MCP：适用于 Claude、Codex、Gemini 以及任何 MCP 客户端

安装

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

快速开始

1. 配置 Claude Code

将以下内容添加到 Claude Code MCP 设置中：

{
  "mcpServers": {
    "regennexus": {
      "command": "regennexus-mcp"
    }
  }
}

2. 与 Claude 搭配使用

完成配置后，Claude 可以控制硬件：

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]

配置

通过环境变量进行配置：

# 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

{
  "mcpServers": {
    "regennexus": {
      "command": "regennexus-mcp",
      "env": {
        "REGENNEXUS_MODE": "local",
        "REGENNEXUS_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

可用工具（免费版）

这些工具由 regennexus 软件包提供（开源）：

GPIO 和基本 I/O

工具	描述
gpio_write	将 GPIO 引脚设为 HIGH（1）或 LOW（0）
gpio_read	读取 GPIO 引脚的当前状态
pwm_write	为电机、LED、舵机设置 PWM 占空比（0-100%）

传感器和 I2C

工具	描述
read_sensor	读取传感器数值（温度、湿度等）
i2c_scan	扫描 I2C 总线上的已连接设备

串口通信

工具	描述
serial_send	通过串口（UART）发送数据
serial_read	从串口读取数据

机器人

工具	描述
robot_arm_move	将机械臂移动到指定关节位置
gripper_control	打开或关闭机器人夹爪

设备管理

工具	描述
list_devices	列出所有已连接的硬件设备
device_info	获取设备详情（CPU、内存、IP、温度）

摄像头

工具	描述
camera_capture	使用摄像头拍摄单张图像

网状网络

工具	描述
list_nodes	列出网状网络中的所有节点
ping_node	Ping 节点并测量网络延迟
send_to_node	向指定节点发送消息/命令
broadcast_message	向所有节点广播消息
find_by_capability	查找具备特定功能的节点

另有提供更多功能的高级工具可供单独使用。

连接模式

本地模式（推荐）

需要在同一台机器上安装 regennexus 软件包。直接导入 UAP 模块，以尽可能降低延迟。无需 API 服务端。

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

这是大多数用户的推荐模式。

远程模式（高级）

通过 HTTP API 连接到作为服务运行的 UAP 实例。需要运行 UAP API 服务端（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

自动模式（默认）

优先尝试本地模式；如果未安装 UAP，则回退到远程模式。

regennexus-mcp  # Auto-detects best mode

独立运行

# Run MCP server
regennexus-mcp

# Or via Python
python -m regennexus_mcp

架构

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

开发

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

相关项目

• RegenNexus UAP - 通用适配器协议
• MCP 规范 - Model Context Protocol

许可证

MIT 许可证