digital-twin-mcp

Упаковываем возможности работы с данными устройств в цифровом двойнике как MCP-инструменты — любой MCP-клиент (WorkBuddy, Claude Desktop, Cursor и т.д.) сможет напрямую запрашивать состояние устройств, читать метрики в реальном времени, получать временные ряды и проверять аварийные сигналы.

Архитектор цифровых конвейеров · Второй блок: конвейер мониторинга устройств Первый блок: https://github.com/xici001/workflow-templates（AI шаблоны автоматизации рабочих процессов)

Что он умеет

Related MCP server: MCP PLC Core

Архитектура

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

• Источник данных v0 — имитированный ПЛК-драйвер (фиксированное случайное зерно, воспроизводимо; температура термопластавтомата намеренно дрейфует вверх к порогу, чтобы наглядно показать эскалацию аварий).

• При подключении реального оборудования наследуйте BasePLCDriver и реализуйте read_metrics / write_value (OPC-UA / Modbus / API шлюза — на выбор), слой Server не меняется.

Быстрый старт

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

Сквозной тест (запуск дочернего процесса сервера и вызов через протокол stdio):

python examples/client_test.py

Подключение к WorkBuddy

Объедините содержимое examples/workbuddy_mcp.json в mcpServers файла C:\Users\33033\.workbuddy\mcp.json, затем на странице управления коннекторами в правом верхнем углу через вход для пользовательских коннекторов нажмите «Доверять» для digital-twin-mcp, чтобы активировать его.

Связь с workflow-templates

Два блока под одним брендом «цифровой конвейер»:

• workflow-templates: упаковывает интеллектуальный труд (анализ финансовых отчётов и т.п.) в рабочие процессы

• digital-twin-mcp: упаковывает возможности работы с данными устройств (цифровой двойник / ПЛК) в MCP-инструменты

В будущем их можно комбинировать: шаблоны рабочих процессов, такие как «отчёт о состоянии устройства», могут напрямую вызывать инструменты этого MCP для получения реальных данных.

Дорожная карта

• v0.1: имитированный ПЛК + 5 инструментов + 2 ресурса + 1 промпт (текущая версия)

• v0.2: реальное подключение OPC-UA, хранение временных рядов (SQLite/InfluxDB), push-уведомления через WebSocket

• v0.3: интеграция 3D-сцены (ресурс макета сцены для рендеринга Three.js), несколько экземпляров фабрики

Лицензия

MIT License