OPC UA MCP Server

基本能力

产品定位

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

核心功能

• 读取 OPC UA 节点：从工业设备中检索实时值。
• 写入 OPC UA 节点：通过向指定节点写入值来控制设备。
• 无缝集成：与 MCP 客户端（如 Claude Desktop）配合使用，实现自然语言交互。

适用场景

• 工业自动化系统的实时监控和控制。
• AI 驱动的工作流与工业系统的集成。

工具列表

• 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 服务器？：在 MCP 客户端配置中设置 OPCUA_SERVER_URL 环境变量。
• 支持的 Python 版本？：Python 3.10 或更高版本。

使用教程

使用依赖

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

安装教程

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

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

MCP 客户端配置

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

调试方式

安装完成后，可以通过 MCP 客户端发送以下命令进行调试： - "What’s the value of node ns=2;i=2?" → 返回当前值。 - "Set node ns=2;i=3 to 100." → 向节点写入 100。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。