Br Automation MCP

🚀 B&R Automation Studio MCP Server

MCP (Model Context Protocol) サーバーで、Claude のような AI アシスタントが B&R Automation Studio プロジェクトと対話できるようになります。自然言語でプロジェクトのビルド、シミュレーターの実行、OPC UA 変数の読み書きがすべて可能です。

✨ 主な機能

• プロジェクトのビルド - シミュレーション用に Automation Studio プロジェクトをコンパイルします。
• シミュレーターの実行 - ARsim を起動し、自動的に接続します。
• OPC UA 統合 - PLC 変数をリアルタイムで読み書きします。

📦 インストール

1. このリポジトリをクローンする

git clone https://github.com/AndrewMusser/br-automation-mcp.git
cd br-automation-mcp

2. Python の依存関係をインストールする

pip install -r requirements.txt

3. サーバー設定を構成する

server.py を編集して、環境に合わせます。

3a. B&R ツールのパス

Automation Studio のインストールに合わせて、これらのパスを更新します。

AS_BUILD_PATH = "C:\\BrAutomation\\AS412\\bin-en\\BR.AS.Build.exe"
PVI_TRANSFER_PATH = "C:\\BrAutomation\\PVI\\V4.12\\PVI\\Tools\\PVITransfer\\PVITransfer.exe"

一般的なインストール場所:

• AS 4.12: C:\BrAutomation\AS412\bin-en\BR.AS.Build.exe
• AS 4.9: C:\BrAutomation\AS49\bin-en\BR.AS.Build.exe
• PVI: 通常 C:\BrAutomation\PVI\V4.x\PVI\Tools\PVITransfer\ の下

3b. OPC UA パラメーター

ARsim と通信するための OPC UA 接続設定を構成します。

OPCUA_HOST = "localhost"
OPCUA_PORT = 4840
OPCUA_USERNAME = "Admin"
OPCUA_PASSWORD = "password"

重要: これらの資格情報は、Automation Studio プロジェクトの OPC UA 構成と一致する必要があります。

• ユーザー/ロール設定: Physical/<Config>/<CPU>/AccessAndSecurity/UserRoleSystem/
• OPC UA 構成: Physical/<Config>/<CPU>/Connectivity/OpcUA/

4. Claude Code を構成する

Claude Code の実行方法に合わせた設定を選択します。

オプション A: ネイティブ Windows (推奨)

Claude Code は、Git Bash、PowerShell、または CMD を介して Windows でネイティブに実行されます。Claude Code と Automation Studio が同じマシンで実行されるため、これは最も簡単な設定です。

Windows に Claude Code をインストールする:

winget install Anthropic.ClaudeCode

設定ファイル: %APPDATA%\Claude\settings.json

設定に追加する:

{
  "mcpServers": [
    {
      "name": "br-automation-mcp",
      "type": "stdio",
      "command": "python",
      "args": ["D:\\path\\to\\br-automation-mcp\\server.py"],
      "enabled": true
    }
  ]
}

アーキテクチャ:

┌─────────────────────────────────────────────────────────────┐
│  Windows                                                    │
│                                                             │
│  ┌─────────────┐    ┌─────────────────────────────────────┐ │
│  │ Claude Code │───▶│  server.py (MCP STDIO Server)       │ │
│  │ (Git Bash)  │    └───────────────┬─────────────────────┘ │
│  └─────────────┘                    │                       │
│                                     │                       │
│         ┌───────────────────────────┼───────────────┐       │
│         ▼                           ▼               ▼       │
│  ┌─────────────┐          ┌──────────────┐  ┌─────────┐     │
│  │ BR.AS.Build │          │ PVITransfer  │  │  OPC UA │     │
│  │   (Build)   │          │  (Simulate)  │  │  (Test) │     │
│  └─────────────┘          └──────────────┘  └─────────┘     │
└─────────────────────────────────────────────────────────────┘

オプション B: WSL2 (クロスプラットフォーム)

Claude Code を WSL2 で実行する場合、PowerShell インターオペラビリティを介して Windows Python サーバーを呼び出すことができます。

設定ファイル: ~/.claude/settings.json

設定に追加する:

{
  "mcpServers": [
    {
      "name": "br-automation-mcp",
      "type": "stdio",
      "command": "powershell.exe",
      "args": [
        "-ExecutionPolicy",
        "Bypass",
        "-File",
        "D:\\path\\to\\br-automation-mcp\\run-server.ps1"
      ],
      "enabled": true
    }
  ]
}

アーキテクチャ:

┌─────────────────────────────────────────────────────────────┐
│  WSL2 (Linux)                                               │
│  ┌─────────────────┐                                        │
│  │   Claude Code   │                                        │
│  │                 │──── powershell.exe ────┐               │
│  └─────────────────┘                        │               │
└─────────────────────────────────────────────│───────────────┘
                                              │
┌─────────────────────────────────────────────│───────────────┐
│  Windows                                    ▼               │
│  ┌─────────────────┐    ┌─────────────────────────────────┐ │
│  │  run-server.ps1 │───▶│  server.py (MCP STDIO Server)   │ │
│  └─────────────────┘    └───────────────┬─────────────────┘ │
│                                         │                   │
│         ┌───────────────────────────────┼───────────────┐   │
│         ▼                               ▼               ▼   │
│  ┌─────────────┐              ┌──────────────┐  ┌─────────┐ │
│  │ BR.AS.Build │              │ PVITransfer  │  │  ARsim  │ │
│  │   (Build)   │              │  (Simulate)  │  │ (OPC UA)│ │
│  └─────────────┘              └──────────────┘  └─────────┘ │
└─────────────────────────────────────────────────────────────┘

5. Claude Code を再起動する

設定を更新した後、Claude Code を再起動して MCP サーバーを読み込みます。

💻 使用例

build_automation_studio_project

Automation Studio プロジェクトをシミュレーション用にコンパイルします。

パラメーター:

• project_file - .apj ファイルのパス (Windows パス)
• configuration - ビルドする構成の名前

使用例: "D:\Projects\MyApp\MyApp.apj のプロジェクトを X20CPU 構成でビルドしてください"

run_automation_studio_simulator

ARsim 構造を作成し、シミュレーターを起動します。

パラメーター:

• ruc_package - RUCPackage.zip のパス (ビルドによって生成されます)
• start_simulator - すぐに起動するかどうか (デフォルト: true)

使用例: "D:\Projects\MyApp\Binaries\X20CPU\X20CP1686X\RUCPackage\RUCPackage.zip の RUC パッケージを使用してシミュレーターを起動してください"

opcua_read_write

実行中のシミュレーター上の OPC UA 変数を読み書きします。

パラメーター:

• node_id - OPC UA ノード識別子 (例: ns=6;s=::TaskName:varName)
• operation - "read" または "write"
• value - 書き込む値 (書き込み操作の場合)
• value_type - データ型: Boolean, Int16, Int32, Float, Double, String

使用例:

• "TempCtrl タスクから温度変数を読み取ってください"
• "TempCtrl タスクで targetTemp を 75.0 に設定してください"

📚 詳細ドキュメント

OPC UA ノード ID 形式

タスクローカル変数の場合:

ns=6;s=::<TaskName>:<VariableName>

グローバル変数の場合:

ns=6;s=::AsGlobalPV:<VariablePath>

注意: 変数は、OPC UA 構成 (OpcUaMap.uad) で公開されている必要があります。

🔧 トラブルシューティング

"Command not found" エラー

Python が Windows の PATH に含まれていること、および server.py の B&R ツールのパスが正しいことを確認してください。

OPC UA 接続エラー

• シミュレーターが実行中であることを確認します。
• 変数が OpcUaMap.uad で公開されていることを確認します。
• デフォルトの資格情報は Admin/password です。

WSL2 が powershell.exe を見つけられない場合

WSL2 で Windows インターオペラビリティが有効になっていることを確認してください (デフォルト)。以下を実行して確認します。

which powershell.exe

📄 ライセンス

MIT ライセンス - 詳細については LICENSE を参照してください。

🔗 貢献

貢献は大歓迎です！問題やプルリクエストを自由に送信してください。

👏 謝辞

• Model Context Protocol by Anthropic
• FastMCP の Python MCP SDK
• B&R Automation の Automation Studio