{"type": "text"}

digital-twin-mcp

Bündeln Sie die Gerätedatenfunktionen digitaler Zwillingsszenarien in MCP-Tools – jeder MCP-Client (WorkBuddy, Claude Desktop, Cursor usw.) kann direkt Gerätestatus abfragen, Echtzeitmetriken lesen, Zeitreihendaten abrufen und Warnungen prüfen.

Architekt der digitalen Pipeline · Zweiter Baustein: Geräteüberwachungspipeline Erster Baustein: https://github.com/xici001/workflow-templates (AI-Automatisierungsworkflow-Vorlagen)

Was es kann

Related MCP server: MCP PLC Core

Architektur

MCP 客户端（WorkBuddy / Claude Desktop / ...）
        │  stdio 或 streamable-http
┌───────▼───────────────┐
│  server.py (FastMCP)  │  ← 工具 / 资源 / 提示词定义
└───────┬───────────────┘
        │
┌───────▼───────────────┐
│  alerts.py             │  告警规则引擎（阈值分级）
│  device_registry.py    │  设备台账 + 指标配置 + 3D 坐标
│  simulator.py          │  PLC 数据驱动（BasePLCDriver 接口）
└───────────────────────┘

• Die v0-Datenquelle ist ein simulierter PLC-Treiber (fester Zufalls-Seed, reproduzierbar; die Temperatur der Spritzgussmaschine driftet absichtlich nahe am Schwellwert nach oben, um die Eskalation von Warnungen zu demonstrieren).

• Für echte Geräte BasePLCDriver erben und read_metrics / write_value implementieren (OPC-UA / Modbus / Gateway-API möglich), ohne Änderungen an der Server-Schicht.

Schnellstart

pip install -e .
# 方式一：stdio 传输（MCP 客户端默认）
python -m digital_twin_mcp.server
# 方式二：streamable-http 传输
python -m digital_twin_mcp.server --transport streamable-http

End-to-End-Test (Server-Subprozess starten und über das stdio-Protokoll aufrufen):

python examples/client_test.py

WorkBuddy-Anbindung

Den Inhalt von examples/workbuddy_mcp.json in mcpServers in C:\Users\33033\.workbuddy\mcp.json einfügen und dann im Verbindungsmanager oben rechts über den Einstieg für benutzerdefinierte Verbindungen bei digital-twin-mcp auf „Vertrauen" klicken, um es zu aktivieren.

Beziehung zu workflow-templates

Zwei Bausteine unter derselben Marke „Digitale Pipeline":

• workflow-templates: Bündelt geistige Arbeit (Finanzberichtsanalyse usw.) in Workflows

• digital-twin-mcp: Bündelt Gerätedatenfunktionen (Digitaler Zwilling / PLC) in MCP-Tools

Beide sind zukünftig kombinierbar: Vorlagen wie der „Gerätegesundheitsbericht" der Workflow-Vorlagen können direkt die Tools dieses MCP aufrufen, um echte Daten abzurufen.

Roadmap

• v0.1: Simulierte PLC + 5 Tools + 2 Ressourcen + 1 Prompt (aktuell)

• v0.2: Echte OPC-UA-Anbindung, Zeitreihendaten in Datenbank (SQLite/InfluxDB), WebSocket-Push

• v0.3: 3D-Szenenkopplung (Szenenlayout-Ressource an Three.js-Rendering anbinden), Multi-Factory-Instanzen

Lizenz

MIT License