What is Opcua Mcp

opcua-mcp is an MCP server designed to connect with OPC UA-enabled industrial systems, enabling AI agents to monitor, analyze, and control operational data in real time.

Use cases

Use cases for opcua-mcp include monitoring real-time data from industrial equipment, controlling device operations through command inputs, and integrating AI-driven workflows with industrial systems.

How to use

To use opcua-mcp, install Python 3.10 or higher, clone the repository, install the required dependencies, and configure the MCP client to connect to the server. You can then use the provided tools to read from and write to OPC UA nodes.

Key features

Key features of opcua-mcp include reading and writing OPC UA node values, real-time data retrieval from industrial devices, and seamless integration with MCP clients for natural language interaction.

Where to use

opcua-mcp can be used in various fields such as industrial automation, smart manufacturing, and any environment that utilizes OPC UA for data exchange between devices.

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 ideal for developers and engineers looking to bridge AI-driven workflows with industrial automation systems.

Features

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

Tools

The server exposes five 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).
  • Returns: A string with the node ID and its value (e.g., “Node ns=2;i=2 value: 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): Value to write (converted based on node type).
  • Returns: A success or error message (e.g., “Successfully wrote 100 to node ns=2;i=3”).

• Browse nodes:

  • Description: Read the value of a specific OPC UA node.

• Read multiple OPC UA Nodes:

  • Description: Read the value of a specific OPC UA node.

• Write to multiple OPC UA Nodes:

  • Description: Read the value of a specific OPC UA node.

Example Prompts

• “What’s 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.13 or higher
• An OPC UA server (e.g., a simulator or real 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 mcp[cli] opcua cryptography

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 licensed under the MIT License. See the LICENSE file for details.