Opcua MCP

🚀 OPC UA MCP Server

An MCP server that connects to OPC UA-enabled industrial systems, allowing AI agents to monitor, analyze, and control operational data in real-time.

This project is suitable for developers and engineers who want to bridge AI-driven workflows with industrial automation systems.

  

🚀 Quick Start

The OPC UA MCP Server is designed to connect with OPC UA - enabled industrial systems, enabling AI agents to interact with industrial operational data. It's an ideal solution for those looking to integrate AI workflows into industrial automation.

✨ Features

• Read OPC UA Nodes: Retrieve real - time values from industrial devices.
• Write OPC UA Nodes: Control devices by writing values to specified nodes.
• Seamless Integration: Work with MCP clients like Claude Desktop for natural language interaction.

Tools

The server provides two tools:

• read_opcua_node:

  • Description: Read the value of a specific OPC UA node.
  • Parameters:
    • node_id (str): OPC UA node ID (e.g., ns=2;i=2).
  • Return: A string containing the node ID and its value (e.g., "The value of node ns=2;i=2 is: 42").

• write_opcua_node:

  • Description: Write a value to a specific OPC UA node.
  • Parameters:
    • node_id (str): OPC UA node ID (e.g., ns=2;i=3).
    • value (str): The value to be written (converted according to the node type).
  • Return: A success or error message (e.g., "Successfully wrote 100 to node ns=2;i=3").

Example Prompts

• "What is the value of node ns=2;i=2?" → Returns the current value.
• "Set node ns=2;i=3 to 100." → Writes 100 to the node.

📦 Installation

Prerequisites

• Python 3.10 or higher
• An OPC UA server (e.g., emulator or actual industrial device)

Install Dependencies

Clone the repository and install the required Python packages:

git clone https://github.com/kukapay/opcua-mcp.git
cd opcua-mcp
pip install asyncua mcp[cli]

MCP Client Configuration

{
 "mcpServers": {
   "opcua-mcp": {
     "command": "python",
     "args": ["path/to/opcua_mcp/main.py"],
     "env": {
        "OPCUA_SERVER_URL": "your-opc-ua-server-url"
     }
   }
 }
}

📄 License

This project is distributed under the MIT License. For more details, see the LICENSE file.