OPC UA MCP Server

OPC UA MCP 服务

一个可连接支持 OPC UA 的工业系统的 MCP 服务，让 AI Agent 能够实时监控、分析和控制运行数据。

本项目适合希望将 AI 驱动的工作流与工业自动化系统连接起来的开发者和工程师。

功能

• 读取 OPC UA 节点：从工业设备获取实时值。
• 写入 OPC UA 节点：通过向指定节点写入值来控制设备。
• 浏览节点：请求列出所有 opcua 节点
• 读取多个 OPC UA 节点：从设备获取多个实时值。
• 写入多个 OPC UA 节点：通过向多个节点写入值来控制设备。
• 无缝集成：可与 Claude Desktop 等 MCP 客户端配合，实现自然语言交互。

工具

该服务提供五种工具：

• read_opcua_node：

  • 说明：读取特定 OPC UA 节点的值。
  • 参数：
    • node_id（str）：OPC UA 节点 ID（例如，ns=2;i=2）。
  • 返回值：包含节点 ID 及其值的字符串（例如，“Node ns=2;i=2 value: 42”）。

• write_opcua_node：

  • 说明：向特定 OPC UA 节点写入值。
  • 参数：
    • node_id（str）：OPC UA 节点 ID（例如，ns=2;i=3）。
    • value（str）：要写入的值（根据节点类型转换）。
  • 返回值：成功或错误消息（例如，“Successfully wrote 100 to node ns=2;i=3”）。

• 浏览节点：

  • 说明：读取特定 OPC UA 节点的值。

• 读取多个 OPC UA 节点：

  • 说明：读取特定 OPC UA 节点的值。

• 写入多个 OPC UA 节点：

  • 说明：读取特定 OPC UA 节点的值。

提示词示例

• “节点 ns=2;i=2 的值是多少？” → 返回当前值。
• “将节点 ns=2;i=3 设为 100。” → 向节点写入 100。

安装

先决条件

• Python 3.13 或更高版本
• OPC UA 服务（例如，模拟器或真实工业设备）

安装依赖

克隆仓库并安装所需的 Python 软件包：

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

MCP 客户端配置

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

许可证

本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。