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:
1. Clone the Repository
```bash
git clone https://github.com/emqx/uns-demo/
cd uns-demo
```
2. The project use `uv` to manage libs and project, please install [uv](https://docs.astral.sh/uv/getting-started/installation/) before getting start.
3. Some dependencies need to be compiled through cmake, please install [cmake](https://cmake.org/download/) before getting start.
4. Install Dependencies and Activate Virtual Environment
```bash
uv sync
uv venv
```
## Pre-conditions
### Install software and configurations
Please refer to [software preparation](docs/software.md).
## Run the application
**Steps**
- Copy `.env.example` to `.env` and modify the values accordingly.
- Run sparkplug mcp server
```bash
uv run spb_server.py
```
- Run biz mcp server
```bash
uv run biz_app.py
```
- Run main application
```bash
uv run main.py
```
- Open http://localhost:8000/ in browser.
- Type questions in the chatbox.
## Demos
Refer to [doc](docs/demo_scenario.md) for detailed demo scenarios.

Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
markitdown
Python tool for converting files and office documents to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.