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 데이터 소스는 시뮬레이션 PLC 드라이버입니다 (고정 랜덤 시드, 재현 가능; 사출기 온도가 일부러 임계값에 가깝게 상승하여 알람 에스컬레이션 데모에 용이).

• 실제 장치 연결 시 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

엔드투엔드 테스트 (server 하위 프로세스를 시작하고 stdio 프로토콜로 호출):

python examples/client_test.py

WorkBuddy 연동

examples/workbuddy_mcp.json의 내용을 C:\Users\33033\.workbuddy\mcp.json의 mcpServers에 병합한 다음, 커넥터 관리 페이지 오른쪽 위의 사용자 정의 커넥터 항목에서 digital-twin-mcp에 대해 「신뢰」를 클릭하여 활성화합니다.

workflow-templates와의 관계

같은 "디지털 파이프라인" 브랜드 아래의 두 블록:

• workflow-templates: 정신 노동 (재무 보고서 분석 등)을 워크플로로 패키징

• digital-twin-mcp: 장치 데이터 기능 (디지털 트윈 / PLC)을 MCP 도구로 패키징

둘은 향후 결합할 수 있습니다: 워크플로 템플릿의 「장치 상태 보고서」 등의 템플릿은 이 MCP의 도구를 직접 호출하여 실제 데이터를 얻을 수 있습니다.

로드맵

• v0.1: 시뮬레이션 PLC + 도구 5개 + 리소스 2개 + 프롬프트 1개 (현재)

• v0.2: OPC-UA 실제 연동, 시계열 데이터 저장 (SQLite/InfluxDB), WebSocket 푸시

• v0.3: 3D 씬 연동 (씬 레이아웃 리소스를 Three.js 렌더링에 연결), 다중 공장 인스턴스

라이선스

MIT License