FME Desktop Live Integration
fme-mcp includes an interactive loopback bridge (127.0.0.1:9877) that allows running FME Workbench desktop sessions to report live translation events directly to connected AI agents and MCP clients.
⚡ How it Works
When you run a translation in FME Workbench:
1. The Startup Script notifies fme-mcp that translation has begun.
2. The Shutdown Script notifies fme-mcp when the translation completes (including final status, features read, features written, and error messages if failed).
3. The bridge communicates over local loopback (127.0.0.1:9877) in sub-millisecond time. If fme-mcp is not running, the scripts catch connection exceptions and fail silently with zero impact on FME.
🛠️ Step-by-Step Setup in FME Workbench
Option A: Per-Workspace Setup
- Open your workspace (
.fmw) in FME Workbench. - In the Navigator pane (left side), expand Workspace Parameters -> Scripting.
- Double-click Startup Python Script, copy and paste the code from
examples/fme-workbench/startup_script.py, and click OK. - Double-click Shutdown Python Script, copy and paste the code from
examples/fme-workbench/shutdown_script.py, and click OK. - Save the workspace.
Option B: Global Setup for All Workspaces
To enable this across all workspaces automatically on your workstation:
1. Locate your FME user plugins directory:
- Windows: Documents\FME\Plugins\Python
- Linux: ~/.fme/Plugins/Python
2. Create an fme_mcp_bridge.py module containing the notification logic to hook into custom transformers or default runners.
Option C: Custom Transformer (MCPConnector)
For feature-by-feature inspection and real-time AI validation directly on the FME canvas:
1. Download or install the custom transformer MCPConnector.fmx (also available on FME Hub).
2. Drop MCPConnector into your workspace.
3. Configure _ai_action (INSPECT, VALIDATE_GEOMETRY, ANALYZE, GEOCODE_AUDIT).
4. Inspect the interactive demo workspace in examples/workbench/MCPConnector_Demo.fmw.
🔍 Diagnostic Verification
To check if the desktop bridge is active and reachable:
Or call thefme_diagnose MCP tool from Claude Desktop or Cursor.