# 🏭 IndustrialOps Industry 4.0 PLC Monitor MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Protocol](https://img.shields.io/badge/MCP-1.0.0-green.svg)](https://modelcontextprotocol.io)
[![Domain](https://img.shields.io/badge/Domain-Industry%204.0%20%26%20IoT-orange.svg)](https://www.siemens.com)

A Model Context Protocol (MCP) server that connects LLMs to factory PLC sensors, machinery health metrics, and predictive maintenance diagnostics.

---

## 🧰 Available MCP Tools

This server exposes **3 tools** over standard I/O (stdio) transport:

### 1. `read_plc_registers`
Fetches current register readings (RPM, PSI, Temperature, Vibration, Status) for a designated PLC.
* **Parameters**:
  - `plc_id` *(string, required)*: PLC identifier (e.g., `"PLC_ASSEMBLY_01"`, `"PLC_PACKAGING_02"`).

### 2. `get_predictive_maintenance_report`
Analyzes machinery vibration telemetry and temperatures to estimate Remaining Useful Life (RUL) hours and schedule preventative inspections.

### 3. `get_energy_consumption`
Exposes active power draw (kW) profiles and efficiency ratings for factory equipment load planning.

---

## 📦 Installation & Quickstart

```bash
# 1. Setup environment
cd industrialops-mcp-server
python -m venv venv
.\venv\Scripts\activate

# 2. Install package
pip install -e .
```

### Claude Desktop Config
```json
{
  "mcpServers": {
    "industrialops": {
      "command": "D:/Projects/industrialops-mcp-server/venv/Scripts/python.exe",
      "args": [
        "-m",
        "industrialops_mcp.server"
      ]
    }
  }
}
```

---

## 🧪 Testing

```bash
python -m pytest -o pythonpath=src
```