pfc-mcp

What it does

Connects AI agents to ITASCA PFC, a powerful discrete element method (DEM) code used in geomechanics. It allows users to run simulations, browse documentation, and execute code through natural conversation.

Tools

• pfc_execute_code: Run PFC commands directly in the simulation.
• pfc_search_docs: Search through PFC command and API documentation.
• pfc_get_doc_tree: Navigate the hierarchical command structure of PFC.
• pfc_monitor_task: Check the progress of long-running simulations.
• pfc_interrupt_task: Stop a running simulation task.
• pfc_list_tasks: View simulation task history.
• pfc_get_plot_docs: Access documentation for specific plot items.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "pfc-mcp": {
      "command": "uvx",
      "args": ["pfc-mcp"]
    }
  }
}

Note: Requires ITASCA PFC 6.0, 7.0, or 9.0 and a bridge (addon.py) running inside the PFC IPython console.

Supported hosts

Claude Desktop, Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI.