digital-twin-mcp

Empaqueta las capacidades de datos de dispositivos de los escenarios de gemelo digital en herramientas MCP: cualquier cliente MCP (WorkBuddy, Claude Desktop, Cursor, etc.) puede consultar directamente el estado de los dispositivos, leer métricas en tiempo real, obtener datos de series temporales y revisar alertas.

El arquitecto del pipeline digital · El segundo bloque: el pipeline de monitorización de dispositivos El primer bloque: https://github.com/xici001/workflow-templates（AI plantillas de flujo de trabajo automatizadas）

Qué ofrece

Related MCP server: MCP PLC Core

Arquitectura

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

• En la v0, la fuente de datos es un controlador PLC simulado (semilla aleatoria fija y reproducible; la temperatura de la máquina de inyección se acerca deliberadamente al umbral para mostrar fácilmente la escalada de alertas).

• Al conectar dispositivos reales, se hereda de BasePLCDriver e se implementa read_metrics / write_value (OPC-UA / Modbus / API de pasarela); la capa del servidor no cambia.

Inicio rápido

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

Prueba de extremo a extremo (inicia el proceso secundario del servidor y realiza llamadas a través del protocolo stdio):

python examples/client_test.py

Integración con WorkBuddy

Fusiona el contenido de examples/workbuddy_mcp.json en la clave mcpServers de C:\Users\33033\.workbuddy\mcp.json. Luego, desde la entrada de conectores personalizados en la esquina superior derecha de la página de administración de conectores, haz clic en «Confitar» sobre digital-twin-mcp para habilitarlo.

Relación con workflow-templates

Dos bloques de construcción bajo la misma marca del "fraseo digital":

• workflow-templates: empaqueta el trabajo intelectual (análisis de informes financieros, etc.) en flujos de trabajo.

• digital-twin-mcp: empaqueta las capacidades de datos de dispositivos (gemelo digital / PLC) en herramientas MCP.

En el futuro, se puede juntarlos: las plantillas como la de «Informe de estado del dispositivo» en los flujos de trabajo pueden llamar directamente a las herramientas de este MCP para obtener datos reales.

Hoja de ruta

• v0.1: PLC simulado + 5 herramientas + 2 recursos + 1 prompt (actual)

• v0.2: integración real con OPC-UA, persistencia de series temporales (SQLite/InfluxDB), envío por WebSocket

• v0.3: vinculación de la scena 3D (el recurso de diseño de scena para renderizado con Tree.js), instáncias para múltiples fábricas

Licencia

MIT License