docs(client): improve server reliability and error handling (#560)

* docs(client): improve server reliability and error handling

- Add a health check step using Ping to verify server availability
- Change error handling for listing tools and resources to terminate the program on failure

Signed-off-by: Bo-Yi Wu <[email protected]>

* style: remove emojis for neutral health check log output

- Remove emojis from health check log and success messages for a more neutral output

Signed-off-by: appleboy <[email protected]>

---------

Signed-off-by: Bo-Yi Wu <[email protected]>
Signed-off-by: appleboy <[email protected]>

Author: appleboy

examples/simple_client/main.go

@@ -121,18 +121,24 @@ func main() {
 		serverInfo.ServerInfo.Version)
 	fmt.Printf("Server capabilities: %+v\n", serverInfo.Capabilities)
 
+	// Perform health check using ping
+	fmt.Println("Performing health check...")
+	if err := c.Ping(ctx); err != nil {
+		log.Fatalf("Health check failed: %v", err)
+	}
+	fmt.Println("Server is alive and responding")
+
 	// List available tools if the server supports them
 	if serverInfo.Capabilities.Tools != nil {
 		fmt.Println("Fetching available tools...")
 		toolsRequest := mcp.ListToolsRequest{}
 		toolsResult, err := c.ListTools(ctx, toolsRequest)
 		if err != nil {
-			log.Printf("Failed to list tools: %v", err)
-		} else {
-			fmt.Printf("Server has %d tools available\n", len(toolsResult.Tools))
-			for i, tool := range toolsResult.Tools {
-				fmt.Printf("  %d. %s - %s\n", i+1, tool.Name, tool.Description)
-			}
+			log.Fatalf("Failed to list tools: %v", err)
+		}
+		fmt.Printf("Server has %d tools available\n", len(toolsResult.Tools))
+		for i, tool := range toolsResult.Tools {
+			fmt.Printf("  %d. %s - %s\n", i+1, tool.Name, tool.Description)
 		}
 	}
 
@@ -142,12 +148,11 @@ func main() {
 		resourcesRequest := mcp.ListResourcesRequest{}
 		resourcesResult, err := c.ListResources(ctx, resourcesRequest)
 		if err != nil {
-			log.Printf("Failed to list resources: %v", err)
-		} else {
-			fmt.Printf("Server has %d resources available\n", len(resourcesResult.Resources))
-			for i, resource := range resourcesResult.Resources {
-				fmt.Printf("  %d. %s - %s\n", i+1, resource.URI, resource.Name)
-			}
+			log.Fatalf("Failed to list resources: %v", err)
+		}
+		fmt.Printf("Server has %d resources available\n", len(resourcesResult.Resources))
+		for i, resource := range resourcesResult.Resources {
+			fmt.Printf("  %d. %s - %s\n", i+1, resource.URI, resource.Name)
 		}
 	}