返回 MCP 目录
public公开dns本地运行

opcua-mcp

OPC UA MCP服务器项目,连接工业系统与AI代理,实现实时监控与控制。

article

README

🚀 OPC UA MCP 服务器

OPC UA MCP 服务器可连接支持 OPC UA 的工业系统,让 AI 代理能够实时监控、分析和控制操作数据。该项目为想把 AI 驱动工作流与工业自动化系统进行桥接的开发者和工程师提供了理想解决方案。

![GitHub License](https://img Shields io/github/license/kukapay/opcua-mcp) ![Python Version](https://img Shields io/badge/python-3.10+-blue) ![Status](https://img Shields io/badge/status-active-brightgreen SVG)

🚀 快速开始

此项目适合希望将 AI 驱动的工作流与工业自动化系统桥接的开发者和工程师,可借助该服务器实现 AI 代理对工业系统操作数据的实时监控、分析和控制。

✨ 主要特性

  • 读取 OPC UA 节点:能够从工业设备中获取实时值,为数据分析和决策提供及时准确的数据。
  • 写入 OPC UA 节点:可通过写入指定节点的值来控制设备,实现对工业设备的灵活操作。
  • 无缝集成:能与如 Claude Desktop 等 MCP 客户端配合使用,实现自然语言交互,降低使用门槛。

工具

服务器提供了两个实用工具:

  • read_opcua_node

    • 描述:读取特定 OPC UA 节点的值。
    • 参数
      • node_id (str):OPC UA 节点 ID(例如 ns=2;i=2)。
    • 返回:节点 ID 及其值的字符串(例如 “节点 ns=2;i=2 的值为:42”)。
  • write_opcua_node

    • 描述:将值写入特定 OPC UA 节点。
    • 参数
      • node_id (str):OPC UA 节点 ID(例如 ns=2;i=3)。
      • value (str):要写的值(根据节点类型进行转换)。
    • 返回:成功或错误消息(例如 “已成功将 100 写入节点 ns=2;i=3”)。

示例提示

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

📦 安装指南

先决条件

  • 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"
     }
   }
 }
}

📄 许可证

此项目根据 MIT License 分发。有关详细信息,请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端