test server connection function

Author: wmill

mcp/minecraft_mcp.py

@@ -535,6 +535,15 @@ async def list_tools() -> List[Tool]:
                         },
                         "required": ["start_x", "start_y", "start_z", "end_x", "end_y", "end_z", "block_type", "stair_type", "staircase_direction"]
                     }
+                ),
+                Tool(
+                    name="test_server_connection",
+                    description="Test if the Minecraft server API is running and responding to requests",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {},
+                        "required": []
+                    }
                 )
             ]
 
@@ -582,6 +591,9 @@ async def call_tool(name: str, arguments: Dict[str, Any]) -> List[ContentBlock]:
                 elif name == "place_stairs":
                     result = await self.place_stairs(**arguments)
                     return result.content
+                elif name == "test_server_connection":
+                    result = await self.test_server_connection()
+                    return result.content
                 else:
                     raise ValueError(f"Unknown tool: {name}")
             except Exception as e:
@@ -1189,6 +1201,58 @@ async def place_stairs(self, start_x: int, start_y: int, start_z: int, end_x: in
                 content=[TextContent(type="text", text=f"Error connecting to Minecraft API: {str(e)}")]
             )
 
+    async def test_server_connection(self) -> CallToolResult:
+        """Test if the Minecraft server API is running and responding."""
+        try:
+            async with httpx.AsyncClient(timeout=5.0) as client:
+                response = await client.get(f"{self.api_base}/")
+                response.raise_for_status()
+                
+                # Check if we get the expected "Hello World" response
+                response_text = response.text.strip()
+                if response_text == "Hello World":
+                    return CallToolResult(
+                        content=[TextContent(
+                            type="text", 
+                            text="✅ Minecraft server is ONLINE and responding correctly"
+                        )]
+                    )
+                else:
+                    return CallToolResult(
+                        content=[TextContent(
+                            type="text", 
+                            text=f"⚠️ Minecraft server responded but with unexpected content: '{response_text}'"
+                        )]
+                    )
+        except httpx.ConnectError:
+            return CallToolResult(
+                content=[TextContent(
+                    type="text", 
+                    text="❌ Cannot connect to Minecraft server - server is OFFLINE or not running"
+                )]
+            )
+        except httpx.TimeoutException:
+            return CallToolResult(
+                content=[TextContent(
+                    type="text", 
+                    text="❌ Minecraft server connection TIMEOUT - server may be overloaded"
+                )]
+            )
+        except httpx.HTTPStatusError as e:
+            return CallToolResult(
+                content=[TextContent(
+                    type="text", 
+                    text=f"❌ Minecraft server returned HTTP error {e.response.status_code}: {e.response.text}"
+                )]
+            )
+        except Exception as e:
+            return CallToolResult(
+                content=[TextContent(
+                    type="text", 
+                    text=f"❌ Error testing server connection: {str(e)}"
+                )]
+            )
+    
     async def run(self):
         """Run the MCP server."""
         print("Starting MCP server stdio connection...", file=sys.stderr)