Uns Demo
What is Uns Demo
uns-demo is a project that demonstrates a Sparkplug B (SPB) implementation, providing a chat-based interface for monitoring and controlling industrial IoT devices. It utilizes a Sparkplug MCP server along with a web application to enable users to interact with device data using natural language.
Use cases
Use cases for uns-demo include monitoring the status of industrial equipment, querying historical performance metrics, and facilitating user interactions through natural language for easier control of IoT devices.
How to use
To use uns-demo, clone the repository, install required dependencies using ‘uv’, set up the environment, and run the Sparkplug MCP server along with the main application. Users can then access the application via a web browser and interact with it through a chat interface.
Key features
Key features of uns-demo include real-time monitoring of device metrics, historical data analysis, a user-friendly chat interface for natural language queries, and integration with Sparkplug B for industrial IoT applications.
Where to use
uns-demo can be used in various fields related to industrial automation, IoT monitoring, and control systems, particularly in environments where real-time data analysis and user-friendly interfaces are essential.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Uns Demo
uns-demo is a project that demonstrates a Sparkplug B (SPB) implementation, providing a chat-based interface for monitoring and controlling industrial IoT devices. It utilizes a Sparkplug MCP server along with a web application to enable users to interact with device data using natural language.
Use cases
Use cases for uns-demo include monitoring the status of industrial equipment, querying historical performance metrics, and facilitating user interactions through natural language for easier control of IoT devices.
How to use
To use uns-demo, clone the repository, install required dependencies using ‘uv’, set up the environment, and run the Sparkplug MCP server along with the main application. Users can then access the application via a web browser and interact with it through a chat interface.
Key features
Key features of uns-demo include real-time monitoring of device metrics, historical data analysis, a user-friendly chat interface for natural language queries, and integration with Sparkplug B for industrial IoT applications.
Where to use
uns-demo can be used in various fields related to industrial automation, IoT monitoring, and control systems, particularly in environments where real-time data analysis and user-friendly interfaces are essential.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Overview
This project demonstrates a Sparkplug B (SPB) implementation featuring a chat-based interface for industrial IoT monitoring and control. It combines a Sparkplug MCP server with a web application that allows users to query device data, analyze historical metrics, and monitor device status through natural language interactions. The system supports both real-time monitoring and historical analysis of device metrics, making it ideal for industrial automation and IoT applications.
Architect diagram
Setup workspace
Follow the steps below to set up and run the application:
- Clone the Repository
git clone https://github.com/emqx/uns-demo/
cd uns-demo
-
The project use
uvto manage libs and project, please install uv before getting start. -
Some dependencies need to be compiled through cmake, please install cmake before getting start.
-
Install Dependencies and Activate Virtual Environment
uv sync
uv venv
Pre-conditions
Install software and configurations
Please refer to software preparation.
Run the application
Steps
- Copy
.env.exampleto.envand modify the values accordingly. - Run sparkplug mcp server
uv run spb_server.py
- Run biz mcp server
uv run biz_app.py
- Run main application
uv run main.py
- Open http://localhost:8000/ in browser.
- Type questions in the chatbox.
Demos
Refer to doc for detailed demo scenarios.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
