Skip to content

server

MCP Server for Vertex-CFD mini-application.

This server provides MCP tools for setting up, running, and analyzing Vertex-CFD simulations.

VertexCFDServer

Bases: BaseMCPServer

MCP Server for Vertex-CFD application.

Source code in src/mada_tools/simulation/vertex_cfd/server.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
class VertexCFDServer(BaseMCPServer):
    """MCP Server for Vertex-CFD application."""

    def __init__(self):
        super().__init__("Vertex-CFD Application", "Vertex-CFD application tools")

        self.vertex_cfd_helper = VertexCFDHelper()

    def _register_tools(self):
        """Register MCP tools for Vertex-CFD operations."""

        @self.mcp.tool()
        async def generate_parameter_runs(
            num_samples: int,
            parameter_names: List[str],
            lower_bounds: List[float],
            upper_bounds: List[float],
            output_dir: str,
            input_deck_location: str | None = None,
            mesh_file_location: str | None = None,
        ) -> str:
            """
            Generate parameter runs for a Vertex-CFD parameter sweep study.

            Creates a structured directory with parameter files for each run,
            ready for job submission to a scheduler like Flux.

            Args:
                num_samples: Number of parameter sets to generate
                parameter_names: List of parameter names (e.g. ["vinit", "porosity"])
                lower_bounds: Lower bounds for each parameter dimension
                upper_bounds: Upper bounds for each parameter dimension
                output_dir: Directory where run folders will be created
                input_deck_location: Location of input deck; defaults to None
                mesh_file_location: Location of mesh file; defaults to None

            Returns:
                str: JSON string with run information for job submission
            """
            return await self.run_tool(
                self.vertex_cfd_helper.generate_parameter_runs,
                num_samples,
                parameter_names,
                lower_bounds,
                upper_bounds,
                output_dir,
                input_deck_location,
                mesh_file_location,
            )

        @self.mcp.tool()
        async def post_process_runs(
            output_dir: str,
        ) -> str:
            """
            Post process parameter runs for a Vertex-CFD parameter sweep study.

            Looks through structured directory with parameter files for each run
            and post proccesses them.

            Args:
                output_dir: Directory where run folders were created

            Returns:
                str: Success string
            """
            return await self.run_tool(self.vertex_cfd_helper.post_process_runs, output_dir)

        @self.mcp.tool()
        async def in_situ_viz() -> dict:
            """
            Create In Situ Visualization for GUI Chat Interface.

            Looks through run00 and creates pngs that get fed into gradio.

            Returns:
                str: Success string
            """
            return await self.run_tool(self.vertex_cfd_helper.in_situ_viz)

main()

Main entry point for the Vertex-CFD MCP server.

Source code in src/mada_tools/simulation/vertex_cfd/server.py 
100
101
102
103
def main():
    """Main entry point for the Vertex-CFD MCP server."""
    server = VertexCFDServer()
    server.run_with_args("vertex_cfd")