OPC UA MCP 服务器

一个连接到支持 OPC UA 的工业系统的 MCP 服务器，允许 AI 代理实时监控、分析和控制操作数据。

该项目非常适合希望将 AI 驱动的工作流程与工业自动化系统结合的开发人员和工程师。

功能

• 读取 OPC UA 节点：从工业设备中检索实时值。
• 写入 OPC UA 节点：通过向指定节点写入值来控制设备。
• 浏览节点：请求列出所有 OPC UA 节点。
• 读取多个 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”）。

• Browse nodes:

  • 描述：读取特定 OPC UA 节点的值。

• Read multiple OPC UA Nodes:

  • 描述：读取特定 OPC UA 节点的值。

• Write to multiple OPC UA Nodes:

  • 描述：读取特定 OPC UA 节点的值。

示例提示

• "What’s the value of node ns=2;i=2?" → 返回当前值。
• "Set node ns=2;i=3 to 100." → 将 100 写入节点。

安装

前提条件

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

安装依赖项

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

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

MCP 客户端配置

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

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。