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：マイクロコントローラーやセンサーと通信します
• 2 つの接続モード：ローカル（直接インポート）またはリモート（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	カメラで静止画を 1 枚撮影します

メッシュネットワーク

ツール	説明
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 - Universal Adapter Protocol
• MCP Specification - Model Context Protocol

ライセンス

MIT ライセンス