pfc-mcp-bridge

English | 简体中文

⚠️ DEPRECATED. This package has been superseded by itasca-mcp-bridge, a product-neutral bridge that supports PFC and FLAC3D from one codebase. New fixes — including the multi-line it.command() deadlock fix — ship there, not here. Install itasca-mcp-bridge and download the new addon.py.

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

Quick Start

One-Step Bootstrap

Download addon.py, then inside PFC either:

• Copy the file contents into the IPython console and run them
• Or download the file and execute it in PFC GUI

What it does:

• If pfc-mcp-bridge is not installed yet, it installs the latest version and starts it
• If it is already installed, it shows the current version and asks whether you want to upgrade before startup
• It then starts the bridge in the current PFC Python environment

The bridge auto-detects the runtime: Qt timer in GUI, blocking loop in console. The bootstrap script also installs a matching websockets version automatically: 9.1 for PFC 6/7 and 16.0 for PFC 9.

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 6/7 use Python 3.6; PFC 9 uses Python 3.10)
• ITASCA PFC 6.0, 7.0, or 9.0
• pfc-mcp-bridge installs a matching websockets dependency automatically: websockets==9.1 on Python 3.6, websockets==16.0 on Python 3.10

Troubleshooting

Development

For the full local-source workflow, see Developer Guide: Install and Run from Source.

To run the bridge from a local source checkout without installing from PyPI, use %run in the PFC IPython console:

%run C:/path/to/pfc-mcp/pfc-mcp-bridge/start_bridge.py

Note: Use forward slashes in the path. Do not wrap it in quotes.

This is equivalent to the PyPI workflow but loads the source directly, so code changes take effect immediately on restart.

For full MCP client setup, see pfc-mcp.

License: MIT (LICENSE).