get_simulation_result
Retrieve detailed results and output files from completed traffic simulations using the Fujitsu Social Digital Twin MCP Server. Obtain simulation status and generated data for analysis.
Instructions
Retrieves the complete results and output files from a finished traffic simulation, including simulation status and generated result files.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | No | ||
| simulation_id | Yes |
Implementation Reference
- src/fujitsu_sdt_mcp/server.py:472-486 (handler)MCP tool handler function that registers and implements the get_simulation_result tool. It validates input, creates FujitsuSocialDigitalTwinClient, calls its get_simulation_result method, and handles errors.@mcp.tool() async def get_simulation_result(simulation_id: str, ctx: Optional[Context] = None) -> Dict[str, Any]: """Retrieves the complete results and output files from a finished traffic simulation, including simulation status and generated result files.""" try: if not simulation_id: return format_api_error(400, "simulationId required") async with await get_http_client() as client: api_client = FujitsuSocialDigitalTwinClient(client) result = await api_client.get_simulation_result(simulation_id) return result except Exception as e: logger.error(f"Result retrieval error: {e}") return format_api_error(500, str(e))
- src/fujitsu_sdt_mcp/server.py:85-95 (helper)Core helper method in FujitsuSocialDigitalTwinClient class that performs the actual HTTP GET request to retrieve simulation results from the Fujitsu API.async def get_simulation_result(self, simulation_id: str) -> Dict[str, Any]: try: response = await self.client.get(f"/api/simulations/{simulation_id}") response.raise_for_status() return format_simulation_result(response.json()) except httpx.HTTPStatusError as e: logger.error(f"Simulation result retrieval error: {e}") return format_api_error(e.response.status_code, str(e)) except Exception as e: logger.error(f"Unexpected error retrieving simulation results: {e}") return format_api_error(500, str(e))
- src/fujitsu_sdt_mcp/server.py:47-51 (helper)Helper function used to standardize successful API responses by wrapping results in a {'success': True, 'data': result} structure.def format_simulation_result(result: Dict[str, Any]) -> Dict[str, Any]: return { "success": True, "data": result }
- src/fujitsu_sdt_mcp/server.py:472-486 (registration)The @mcp.tool() decorator registers this function as an MCP tool named 'get_simulation_result'.@mcp.tool() async def get_simulation_result(simulation_id: str, ctx: Optional[Context] = None) -> Dict[str, Any]: """Retrieves the complete results and output files from a finished traffic simulation, including simulation status and generated result files.""" try: if not simulation_id: return format_api_error(400, "simulationId required") async with await get_http_client() as client: api_client = FujitsuSocialDigitalTwinClient(client) result = await api_client.get_simulation_result(simulation_id) return result except Exception as e: logger.error(f"Result retrieval error: {e}") return format_api_error(500, str(e))