digital-twin-mcp

デジタルツインシナリオのデバイスデータ機能をMCPツールとしてパッケージ化——あらゆるMCPクライアント（WorkBuddy、Claude Desktop、Cursorなど）から、デバイス状態の照会、リアルタイム指標の読み取り、時系列データの取得、アラートの確認が直接行えます。

デジタルパイプラインの設計者 · 2つ目の積み木：デバイス監視パイプライン 1つ目の積み木：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 との関係

同じ「デジタルパイプライン」ブランドの2つの積み木：

• workflow-templates：頭脳労働（財務分析など）をワークフローとしてパッケージ化

• digital-twin-mcp：デバイスデータ機能（デジタルツイン / PLC）をMCPツールとしてパッケージ化

両者は将来組み合わせ可能：ワークフローテンプレートの「デバイスヘルスレポート」などのテンプレートは、このMCPのツールを直接呼び出して実データを取得できます。

ロードマップ

• v0.1：シミュレートPLC + 5ツール + 2リソース + 1プロンプト（現在）

• v0.2：OPC-UA実接続、時系列データのDB保存（SQLite/InfluxDB）、WebSocketプッシュ

• v0.3：3Dシーン連携（シーンレイアウトリソースをThree.jsレンダリングに接続）、マルチファクトリーインスタンス

ライセンス

MIT License