refactor(mcp-server-filesystem): Enhance comments in McpResources and McpTools

Author: codeboyzhou

mcp-server-filesystem/src/main/java/com/github/mcp/examples/server/filesystem/McpResources.java

@@ -26,8 +26,10 @@ public static McpServerFeatures.SyncResourceSpecification filesystem() {
             "file://system", "filesystem", "File system operations interface", "text/plain",
             new McpSchema.Annotations(List.of(McpSchema.Role.ASSISTANT, McpSchema.Role.USER), 1.0)
         );
-        // Step 2: Create a handler that returns the contents of the resource.
+
+        // Step 2: Create a resource specification with the resource and a read handler.
         return new McpServerFeatures.SyncResourceSpecification(resource, (exchange, request) -> {
+            // Step 3: Return the contents of the resource.
             McpSchema.ResourceContents contents = new McpSchema.TextResourceContents(
                 resource.uri(), resource.mimeType(), "No specific resource contents, just use the tools."
             );

mcp-server-filesystem/src/main/java/com/github/mcp/examples/server/filesystem/McpTools.java

@@ -33,8 +33,10 @@ public final class McpTools {
     public static McpServerFeatures.SyncToolSpecification readFile() throws IOException {
         // Step 1: Load the JSON schema for the tool input arguments.
         final String schema = FileOperationHelper.readResourceAsString("schema/read-file-tool-input-json-schema.json");
+
         // Step 2: Create a tool with name, description, and JSON schema.
         McpSchema.Tool tool = new McpSchema.Tool("read_file", "Read complete contents of a file.", schema);
+
         // Step 3: Create a tool specification with the tool and the call function.
         return new McpServerFeatures.SyncToolSpecification(tool, (exchange, arguments) -> {
             // Step 4: Read the file and return the result.