pfc-mcp-bridge 0.2.0

WebSocket bridge for ITASCA PFC - runs inside PFC GUI to enable remote simulation control

pfc-mcp-bridge

English | 简体中文

Runtime bridge that runs inside a PFC process and enables execution tools for pfc-mcp.

Quick Start

Install and run in PFC Python console:

import pip
pip.main(["install", "--user", "-U", "pfc-mcp-bridge"])

import pfc_mcp_bridge
pfc_mcp_bridge.start()

The bridge auto-detects the runtime: Qt timer in GUI, blocking loop in console.

Expected output:

============================================================
PFC Bridge Server
============================================================
  URL:         ws://localhost:9001
  Log:         /your-working-dir/.pfc-mcp-bridge/bridge.log
  Callbacks:   Interrupt, Diagnostic (registered)
============================================================

Requirements

• Python >= 3.6 (PFC embedded Python)
• ITASCA PFC 7.0+
• websockets==9.1 (installed automatically with pfc-mcp-bridge)

Troubleshooting

Symptom	Fix
Server won't start	In PFC Python/IPython console, install/upgrade pfc-mcp-bridge with import pip; pip.main(["install", "--user", "-U", "pfc-mcp-bridge"])
Port in use	Use pfc_mcp_bridge.start(port=9002) in PFC Python, then set MCP server env PFC_MCP_BRIDGE_URL=ws://localhost:9002
Connection failed	Check bridge is running, port is available, see .pfc-mcp-bridge/bridge.log
No task execution / cannot connect from MCP	If execution tools return ok=false, error.code=bridge_unavailable, and error.details.reason=cannot connect to bridge service, ensure bridge is running in PFC (pfc_mcp_bridge.start()) and PFC_MCP_BRIDGE_URL matches bridge URL

For full MCP client setup, see pfc-mcp.

License: MIT (LICENSE).