OPC UA MCP Server

1# OPC UA MCP Server
2 
3An MCP server that connects to OPC UA-enabled industrial systems, allowing AI agents to monitor, analyze, and control operational data in real time.
4 
5This project is ideal for developers and engineers looking to bridge AI-driven workflows with industrial automation systems.
6 
7![GitHub License](https://img.shields.io/github/license/kukapay/opcua-mcp)
8![Python Version](https://img.shields.io/badge/python-3.13+-blue)
9![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
10 
11## Features
12 
13- **Read OPC UA Nodes**: Retrieve real-time values from industrial devices.
14- **Write to OPC UA Nodes**: Control devices by writing values to specified nodes.
15- **Browse nodes**: Request to list allopcua  nodes
16- **Read multiple OPC UA Nodes**: Retrieve multiple real-time values from devices.
17- **Write to multiple OPC UA Nodes**: Control devices by writing values to multiple nodes.
18- **Seamless Integration**: Works with MCP clients like Claude Desktop for natural language interaction.
19 
20 
21### Tools
22The server exposes five tools:
23- **`read_opcua_node`**:
24  - **Description**: Read the value of a specific OPC UA node.
25  - **Parameters**:
26    - `node_id` (str): OPC UA node ID (e.g., `ns=2;i=2`).
27  - **Returns**: A string with the node ID and its value (e.g., "Node ns=2;i=2 value: 42").
28 
29- **`write_opcua_node`**:
30  - **Description**: Write a value to a specific OPC UA node.
31  - **Parameters**:
32    - `node_id` (str): OPC UA node ID (e.g., `ns=2;i=3`).
33    - `value` (str): Value to write (converted based on node type).
34  - **Returns**: A success or error message (e.g., "Successfully wrote 100 to node ns=2;i=3").
35 
36- **`Browse nodes`**:
37  - **Description**: Read the value of a specific OPC UA node.
38 
39- **`Read multiple OPC UA Nodes`**:
40  - **Description**: Read the value of a specific OPC UA node.
41 
42- **`Write to multiple OPC UA Nodes`**:
43  - **Description**: Read the value of a specific OPC UA node.
44 
45 
46### Example Prompts
47 
48- "What’s the value of node ns=2;i=2?" → Returns the current value.
49- "Set node ns=2;i=3 to 100." → Writes 100 to the node.
50 
51## Installation
52 
53### Prerequisites
54- Python 3.13 or higher
55- An OPC UA server (e.g., a simulator or real industrial device)
56 
57### Install Dependencies
58Clone the repository and install the required Python packages:
59 
60```bash
61git clone https://github.com/kukapay/opcua-mcp.git
62cd opcua-mcp
63pip install mcp[cli] opcua cryptography
64```
65 
66### MCP Client Configuration
67 
68```json
69{
70 "mcpServers": {
71   "opcua-mcp": {
72     "command": "python",
73     "args": ["path/to/opcua_mcp/main.py"],
74     "env": {
75        "OPCUA_SERVER_URL": "your-opc-ua-server-url"
76     }
77   }
78 }
79}
80```
81 
82 
83## License
84This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
85