Br Automation MCP

🚀 B&R Automation Studio MCP 服務器

這是一個 MCP（模型上下文協議） 服務器，它能讓像 Claude 這樣的 AI 助手與 B&R Automation Studio 項目進行交互。通過自然語言，你可以構建項目、運行模擬器以及讀寫 OPC UA 變量。

🚀 快速開始

此服務器可使 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 WSL (跨平臺)

如果你在 WSL (Windows Subsystem for Linux) 中運行 Claude Code，它可以通過 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.psl", 
            ], 
            enabled": true 
        } 
    ] 
} 

架構:

┌─────────────────────────────────────────────────────────────┐ 
│ WSL (Linux) │ 
│ ┌─────────────────┐ │ 
│ │ Claude Code │ │ 
│ │ │──── powershell.exe ────┐ │ 
│ └─────────────────┘ │ │ 
└─────────────────────────────────────────────│───────────────┘ 
│ 
┌─────────────────────────────────────────────│───────────────┐ 
│ Windows ▼ │ 
│ ┌─────────────────┐ ┌─────────────────────────────────┐ │ 
│ │ run server.psl │───▶│ 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 - 要構建的配置名稱

示例提示: "使用X20CPU配置構建我位於D:\Projects\MyApp\MyApp.apj處項目

run_automation_studio_simulator

創建ARsim結構並啟動模擬器

參數: ruc_package - RUCPackage.zip的路徑 (由構建生成) start_simulator - 是否立即啟動 (默認: true)

示例提示: "使用位於D:\Projects\MyApp\Binaries\X20CPU\X20CP1686X\RUCPackage\RUCPackage.zip處RUCPackage啟動模擬器

opcua_read_write

在運行模擬器上讀取或寫入OPC UA變量

參數: node_id - OPC UA節點標識符 (例如, ns=6;s=::TaskName:varName) operation - read'或'write' value -寫入的值 (用於寫入操作) value_type -數據類型 Boolean, Int16, Int 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) 中公開才能訪問

📚詳細文檔

OPC UA節點ID格式

對於任務本地變量:

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

對於全局變量:

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

注意變量必須OPC UA配置 (OpcUaMap.uad) 中公開才能訪問

故障排除

'命令未找到'錯誤

確保Python位於Windows PATH中並且server.py中B&R工具路徑正確

OPC UA連接失敗

驗證模擬器正在運行 檢查變量是否OpcUaMap.uad中公開 默認憑據為Admin/password

WSL找不到powershell.exe

確保WSL啟用了Windows互操作 (默認) 檢查方法

which powershell.exe 

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

貢獻說明

歡迎貢獻代碼！請隨時提交問題報告和拉取請求

致謝

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