reorg sections for java; add code snippet

lilyjma · lilyjma · commit f8618bac6c49 · 2026-04-06T20:01:34.000-04:00
diff --git a/articles/azure-functions/functions-bindings-mcp-resource-trigger.md b/articles/azure-functions/functions-bindings-mcp-resource-trigger.md
@@ -299,8 +299,7 @@ For the complete code example, see [function_app.py](https://github.com/Azure-Sa
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
-
-The following example shows a Java function that serves an HTML weather widget as an MCP resource:
+The following code creates an endpoint to expose a resource named `Weather Widget` that serves an interactive weather display as bundled HTML content. The resource uses the `ui://` scheme to indicate it's an MCP App UI resource.
 
 ```java 
 @FunctionName("GetWeatherWidget")
@@ -321,28 +320,67 @@ public String getWeatherWidget(
     executionContext.getLogger().info("GetWeatherWidget: serving weather widget UI");
 
     java.io.File file = new java.io.File("app/dist/index.html");
-    if (file.exists()) {
-        try {
-            return java.nio.file.Files.readString(file.toPath(), StandardCharsets.UTF_8);
-        } catch (IOException e) {
-            executionContext.getLogger().log(Level.WARNING, "Failed to read UI from file", e);
-        }
-    }
-
-    return "<html><body><p>Weather widget UI not found.</p></body></html>";
+    return java.nio.file.Files.readString(file.toPath(), StandardCharsets.UTF_8);
 }
 ```
 
 The `RESOURCE_METADATA` constant is defined as a JSON string that provides additional MCP metadata surfaced via the protocol's `_meta` field:
 
 ```java
 private static final String RESOURCE_METADATA = """
-        {
-            "ui": {
-                "prefersBorder": true
-            }
+    {
+        "ui": {
+            "prefersBorder": true
+        }
+    }
+    """;
+```
+
+A tool can reference this resource by declaring a `resourceUri` in its metadata, pointing to `ui://weather/index.html`. When the tool is invoked, the MCP host fetches the resource and renders it:
+
+```java
+
+private static final String TOOL_METADATA = """
+    {
+        "ui": {
+            "resourceUri": "ui://weather/index.html"
+        }
+    }
+    """;
+
+@FunctionName("GetWeather")
+public String getWeather(
+        @McpToolTrigger(
+                name = "GetWeather",
+                description = "Returns current weather for a location via Open-Meteo.")
+        @McpMetadata(
+                name = "GetWeather",
+                json = TOOL_METADATA)
+        String context,
+        @McpToolProperty(
+                name = "location",
+                propertyType = "string",
+                description = "City name to check weather for (e.g., Seattle, New York, Miami)")
+        String location,
+        final ExecutionContext executionContext) {
+            Object result = weatherService.getCurrentWeather(location);
+            return MAPPER.writeValueAsString(result);
         }
-        """;
+```
+
+
+For the complete code example, see [McpWeatherApp](https://github.com/Azure-Samples/remote-mcp-functions-java/tree/main/samples/McpWeatherApp/src/main/java/com/function/weather).  
+
+### Dependency
+
+Add the following dependency to your project's `pom.xml` file. The MCP annotations are included in the Azure Functions Java library starting from version **3.2.4**:
+
+```xml name=pom.xml
+<dependency>
+    <groupId>com.microsoft.azure.functions</groupId>
+    <artifactId>azure-functions-java-library</artifactId>
+    <version>3.2.4</version>
+</dependency>
 ```
 ::: zone-end
 
@@ -457,19 +495,6 @@ The `@McpMetadata` annotation supports the following properties:
 @McpMetadata(
         name = "context",
         json = "{\"author\": \"John Doe\", \"version\": 1.0}")
-String context
-```
-
-## Setup
-
-Add the following dependency to your project's `pom.xml` file. The MCP annotations are included in the Azure Functions Java library starting from version **3.2.4**:
-
-```xml name=pom.xml
-<dependency>
-    <groupId>com.microsoft.azure.functions</groupId>
-    <artifactId>azure-functions-java-library</artifactId>
-    <version>3.2.4</version>
-</dependency>
 ```
 ::: zone-end
 
