OpenFOAM MCP Server

🚀 Intelligent CFD education and problem-solving system - OpenFOAM Model Context Protocol server with AI-powered educational capabilities including Socratic questioning, context engineering, and systematic error resolution.

📊 Current Status

| Component | Status | Details | |-----------|--------|---------| | MCP Server | ✅ Working | JSON-RPC 2.0, 12 registered tools, Claude Code integration | | OpenFOAM Integration | ⚠️ Partial | Basic connectivity, solver migration needed for OF12 | | Educational AI | ✅ Working | Context engine, Socratic questioning, adaptive learning | | Mesh & Geometry Tools | ✅ Complete | Mesh quality assessment, STL analysis with snappyHexMesh guidance | | RDE Analysis Suite | ✅ Complete | 2D/3D wave analysis, geometry generation, performance calculation | | Pipe Flow Analysis | ✅ Complete | Full implementation with mesh generation and validation | | Advanced Physics | ⚠️ In Development | Heat transfer, multiphase frameworks exist, need implementation |

Overall System Status: 75% Functional - Core educational, mesh quality, and RDE analysis capabilities working.

🎯 Why This MCP? The CFD-AI Educational Revolution

The Problem: CFD Expertise Barrier

• Complex Setup: OpenFOAM requires deep expertise in mesh generation, boundary conditions, and solver selection
• Physics Knowledge: CFD analysis demands understanding of fluid dynamics, heat transfer, and numerical methods
• Time-Intensive: Manual setup and analysis can take hours to days for complex cases
• Error-Prone: Incorrect boundary conditions or solver settings lead to non-physical results
• Learning Curve: Traditional CFD tools lack educational guidance and progressive learning support

The Solution: Intelligent CFD Education System

This revolutionary MCP transforms CFD learning and problem-solving through:

• Context Engineering: Advanced user modeling that tracks CFD concept understanding and adapts complexity
• Socratic Questioning: Strategic questioning engine with 4 proven patterns (Clarify, Explore, Confirm, Apply)
• Intelligent Parameter Extraction: Natural language to CFD parameter translation with confidence scoring
• Advanced Error Resolution: 5 Whys methodology with research-backed solutions and academic references
• CFD Knowledge Graph: Concept relationship mapping for guided learning paths
• Dual-Terminal Architecture: Seamless OpenFOAM execution with intelligent conversation flow

Market Impact

• Revolutionizes CFD Education: First AI-driven system that teaches CFD through guided discovery
• Democratizes CFD: Makes professional fluid dynamics analysis accessible through natural language
• Accelerates Learning: Progressive complexity adaptation based on user understanding level
• Enhances Problem-Solving: 5 Whys error resolution with research-backed solutions
• Professional Integration: Maintains full OpenFOAM compatibility with intelligent guidance overlay

🛠️ Intelligent CFD Capabilities

🧠 Advanced AI Features

Context Engineering System

• Enhanced User Modeling: Tracks CFD concept understanding, experience level, and learning progress
• Confidence Scoring: Monitors user comprehension across fluid dynamics, heat transfer, and numerical methods
• Adaptive Complexity: Automatically adjusts explanations and guidance based on user expertise
• Learning Path Optimization: Suggests optimal concept progression for effective CFD mastery

Socratic Questioning Engine

• Strategic Question Patterns: 4 proven educational strategies for progressive learning
  • 🔍 CLARIFY: "What specifically do you mean by turbulent flow in this context?"
  • 🌊 EXPLORE: "What would happen if we increased the Reynolds number to 500,000?"
  • ✅ CONFIRM: "So you're saying that pressure drop increases quadratically with velocity?"
  • 🎯 APPLY: "How would you use the Moody diagram for this pipe flow problem?"
• Context-Aware Questions: Generated based on user's current understanding and conversation history
• Progressive Difficulty: Questions adapt complexity to build understanding systematically

Intelligent Parameter Extraction

• Natural Language Processing: Converts conversational descriptions to precise CFD parameters
• Physics Validation: Ensures extracted parameters are physically reasonable and consistent
• Confidence Scoring: Provides certainty levels for parameter extraction accuracy
• Interactive Clarification: Asks intelligent follow-up questions when parameters are ambiguous

Advanced Error Resolution

• 5 Whys Methodology: Systematic root cause analysis for CFD simulation failures
• Research Integration: Academic paper database with evidence-based solutions
• Diagnostic Guidance: Step-by-step troubleshooting with educational explanations
• Prevention Strategies: Teaches users to avoid similar issues through understanding

CFD Knowledge Graph

• Concept Relationships: Maps connections between fluid mechanics, heat transfer, and numerical methods
• Learning Dependencies: Identifies prerequisite concepts for advanced topics
• Skill Assessment: Evaluates user knowledge gaps and suggests focused learning areas
• Academic References: Links concepts to authoritative sources and research papers

📋 Available MCP Tools

The server provides 12 registered tools across different CFD domains:

| Tool | Description | Status | |------|-------------|--------| | start_cfd_assistance | Start an intelligent CFD conversation with context engineering | ✅ Working | | continue_cfd_conversation | Continue CFD discussion with adaptive Socratic questioning | ✅ Working | | execute_openfoam_operation | Execute OpenFOAM operations (mesh, solve, post-process) | ✅ Working | | analyze_cfd_results | Analyze CFD results with educational explanations | ✅ Working | | get_cfd_learning_guidance | Get personalized CFD learning recommendations | ✅ Working | | assess_mesh_quality | Mesh quality analysis with solver compatibility assessment | ✅ Working | | analyze_stl_geometry | STL preprocessing and snappyHexMesh readiness analysis | ✅ Working | | analyze_turbulent_flow | Comprehensive turbulent flow analysis with model recommendations | ✅ Working | | analyze_rde_waves_2d | 2D RDE wave detection and performance metrics | ✅ Working | | generate_rde_3d_geometry | 3D RDE annular geometry generation with blockMesh | ✅ Working | | analyze_rde_waves_3d | 3D RDE wave propagation and interaction analysis | ✅ Working | | calculate_rde_3d_performance | 3D RDE thrust, Isp, and efficiency calculations | ✅ Working |

Core Analysis Tools

1. 🔬 Pipe Flow Analysis (run_pipe_flow)

Physics: Internal flow in circular pipes with laminar flow analysis

• Calculates: Reynolds number, friction factor, pressure drop, wall shear stress
• Applications: Hydraulic systems, pipeline design, HVAC analysis
• Solvers: icoFoam (laminar), foamRun -solver incompressibleFluid (in development)
• Status: ✅ Working - Complete implementation with mesh generation
• Current Limitations: For advanced turbulent analysis, use analyze_turbulent_flow

1b. 🌀 Turbulent Flow Analysis (analyze_turbulent_flow)

Physics: Comprehensive turbulent flow analysis for pipes, channels, and external flows

• Turbulence Models: Automatic selection between k-epsilon and k-omega SST with justification
• Friction Factors: Smooth pipes (Blasius) and rough pipes (Colebrook-White/Swamee-Jain)
• Pipe Roughness: Built-in database with 13 standard materials (steel, cast iron, PVC, etc.)
• Calculates:
  • Reynolds number and flow regime classification
  • Friction factor (smooth and rough pipes)
  • Pressure drop and head loss (Darcy-Weisbach)
  • Wall shear stress and friction velocity
  • y+ estimation and first cell height recommendations
  • Turbulent inlet conditions (k, ε, ω, νt)
• Mesh Guidance: y+ validation for wall functions, first cell height calculator
• Educational Content: Socratic questions, physics explanations, model comparisons
• Status: ✅ Working - Complete implementation with validation

2. ✈️ External Flow Analysis (analyze_external_flow)

Physics: Basic aerodynamics analysis (simplified implementation)

• Calculates: Basic flow patterns and pressure distributions
• Applications: Preliminary aerodynamic assessments
• Solvers: foamRun -solver incompressibleFluid (basic configuration)
• Status: ⚠️ Partial - Framework exists, needs solver integration fixes
• Current Limitations: Advanced turbulence models not fully integrated

3. 🌡️ Heat Transfer Analysis (analyze_heat_transfer)

Physics: Basic heat transfer analysis (limited implementation)

• Calculates: Temperature distributions (simplified cases)
• Applications: Basic thermal analysis
• Solvers: Heat transfer solvers integration in progress
• Status: ⚠️ In Development - Basic framework, solver integration needed
• Current Limitations: Conjugate heat transfer not yet implemented

4. 🌊 Multiphase Flow Analysis (analyze_multiphase_flow)

Physics: Multiphase flow framework (early development)

• Applications: Basic free surface flow analysis
• Solvers: Multiphase solver integration planned
• Status: ⚠️ Framework Only - Tool structure exists, solver integration needed
• Current Limitations: VOF methods and advanced mult