Merge pull request #313022 from ggailey777/mcp-java-updates

ttorble · web-flow · commit 02bed81a3a0f · 2026-03-13T10:30:19.000Z
[Functions] Update MCP server docs with Java examples and correct paths
diff --git a/articles/azure-functions/scenario-custom-remote-mcp-server.md b/articles/azure-functions/scenario-custom-remote-mcp-server.md
@@ -128,6 +128,13 @@ In a terminal window, go to the `FunctionsMcpTool` project folder:
 cd src/FunctionsMcpTool
 ```
 ::: zone-end  
+::: zone pivot="programming-language-java"  
+In a terminal window, go to the `FunctionsMcpTool` project folder:
+
+```console
+cd samples/FunctionsMcpTool
+```
+::: zone-end  
 ::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 
 [!INCLUDE [run-locally](../../includes/functions-mcp-run-locally.md)] 
@@ -180,11 +187,11 @@ The function code for the MCP server tools is defined in the `src` folder. The `
 You can view the complete project template in the [Azure Functions .NET MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-dotnet) GitHub repository.
 ::: zone-end  
 ::: zone pivot="programming-language-java"
-The function code for the MCP server tools is defined in the `src/main/java/com/function/` folder. The `@McpToolTrigger` annotation exposes the functions as MCP Server tools:
+The function code for the MCP server tools is defined in the `samples/FunctionsMcpTool/src/main/java/com/function/` folder. The `@McpToolTrigger` annotation exposes the functions as MCP Server tools:
 
-<!- :::code language="java" source="~/functions-scenarios-custom-mcp-java/src/main/java/com/function/HelloWorld.java" range="35-51" ::: >
+:::code language="java" source="~/functions-scenarios-custom-mcp-java/samples/FunctionsMcpTool/src/main/java/com/function/HelloWorld.java" range="26-40" :::
 
-<!- :::code language="java" source="~/functions-scenarios-custom-mcp-java/src/main/java/com/function/Snippets.java" range="80-118" ::: >
+:::code language="java" source="~/functions-scenarios-custom-mcp-java/samples/FunctionsMcpTool/src/main/java/com/function/Snippets.java" range="50-83" :::
 
 You can view the complete project template in the [Azure Functions Java MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-java) GitHub repository.
 ::: zone-end  
diff --git a/articles/azure-functions/scenario-mcp-apps.md b/articles/azure-functions/scenario-mcp-apps.md
@@ -21,9 +21,9 @@ After running the project locally and verifying your code by using GitHub Copilo
 
 Because the new app runs on the Flex Consumption plan, which follows a _pay-for-what-you-use_ billing model, completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
 
-::: zone pivot="programming-language-javascript,programming-language-java"  
+::: zone pivot="programming-language-javascript"  
 > [!IMPORTANT]  
-> While [creating MCP Apps](./functions-bindings-mcp.md) is supported for Java and JavaScript, this quickstart currently only has examples for C#, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
+> While [creating MCP Apps](./functions-bindings-mcp.md) is supported for JavaScript, this quickstart currently only has examples for C#, Java, Python, and TypeScript. To complete this quickstart, select one of these supported languages at the top of the article. 
 ::: zone-end  
 
 [!INCLUDE [functions-mcp-extension-powershell-note](../../includes/functions-mcp-extension-powershell-note.md)]  
@@ -34,12 +34,18 @@ This article supports version 4 of the Node.js programming model for Azure Funct
 ::: zone pivot="programming-language-python"
 This article supports version 2 of the Python programming model for Azure Functions.
 ::: zone-end
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 ## Prerequisites
 ::: zone-end  
 ::: zone pivot="programming-language-csharp"  
 + [.NET 10 SDK](https://dotnet.microsoft.com/download) 
 ::: zone-end  
+::: zone pivot="programming-language-java"  
++ [Java 17 Developer Kit](/azure/developer/java/fundamentals/java-support-on-azure)
+    + If you use another [supported version of Java](supported-languages.md?pivots=programming-language-java#languages-by-runtime-version), update the project's `pom.xml` file. 
+    + Set the `JAVA_HOME` environment variable to the install location of the correct version of the Java Development Kit (JDK).
++ [Apache Maven 3.8.x](https://maven.apache.org)  
+::: zone-end  
 <!-- replace when supported 
 ::: zone pivot="programming-language-javascript,programming-language-typescript" -->
 ::: zone pivot="programming-language-typescript"
@@ -57,7 +63,7 @@ This article supports version 2 of the Python programming model for Azure Functi
 
 + [Azure Developer CLI](/azure/developer/azure-developer-cli/install-azd) version 1.23.x or a later version 
 ::: zone-end  
-::: zone pivot="programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-java,programming-language-python,programming-language-typescript" 
 + [Node.js](https://nodejs.org/) (required to build the MCP Apps UI)
 
 + [Visual Studio Code](https://code.visualstudio.com/) with these extensions:
@@ -66,7 +72,7 @@ This article supports version 2 of the Python programming model for Azure Functi
 
     + [Azure Developer CLI extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.azure-dev).
 ::: zone-end   
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 + [Azurite storage emulator](../storage/common/storage-install-azurite.md#install-azurite) 
 
 + [Azure CLI](/cli/azure/install-azure-cli). You can also run Azure CLI commands in [Azure Cloud Shell](../cloud-shell/overview.md).
@@ -78,12 +84,6 @@ This article supports version 2 of the Python programming model for Azure Functi
 Use the Azure Developer CLI to create an Azure Functions code project from a template.
 
 1. In Visual Studio Code, open a folder or workspace where you want to create your project.
-::: zone-end 
-::: zone pivot="programming-language-python,programming-language-typescript" 
-1. Press <kbd>F1</kbd> to open the command palette. Search for and run `Azure Developer CLI (azd): init`.
-
-1. When prompted, select **Select a template**.
-
 ::: zone-end  
 ::: zone pivot="programming-language-csharp"  
 2. Run the following command in the Terminal: 
@@ -92,7 +92,12 @@ Use the Azure Developer CLI to create an Azure Functions code project from a tem
     azd init --template remote-mcp-functions-dotnet -e mcpweather-dotnet
     ```
 
-    This command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-dotnet) and initializes the project in the current folder. The -e flag sets a name for the current environment. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in names of the resources you create in Azure.
+    This command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-dotnet) and initializes the project in the current folder. The -e flag sets a name for the current environment. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in names of the resources you create in Azure.  
+::: zone-end  
+::: zone pivot="programming-language-java,programming-language-python,programming-language-typescript" 
+2. Press <kbd>F1</kbd> to open the command palette. Search for and run `Azure Developer CLI (azd): init`.
+
+3. When prompted, select **Select a template**.  
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"  
 4. Search for and select **Remote MCP Functions with TypeScript**.
@@ -108,7 +113,14 @@ Use the Azure Developer CLI to create an Azure Functions code project from a tem
 
     The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-python) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in the names of the resources you create in Azure. 
 ::: zone-end
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-java"  
+4. Search for and select **Remote MCP Functions with Java**.
+
+5. When prompted, enter `mcpweather-java` as the environment name.
+
+    The command pulls the project files from the [template repository](https://github.com/Azure-Samples/remote-mcp-functions-java) and initializes the project in the current folder. In `azd`, the environment maintains a unique deployment context for your app, and you can define more than one. It's also used in names of the resources you create in Azure. 
+::: zone-end
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 ## Start the storage emulator
 
 [!INCLUDE [start-storage-emulator](../../includes/functions-mcp-start-storage-emulator.md)]
@@ -128,6 +140,18 @@ The MCP Apps weather tool includes a frontend application that you must build be
     cd ../
     ```
 
+::: zone-end
+::: zone pivot="programming-language-java"  
+
+1. In the terminal, go to the UI app folder and build the application:
+
+    ```console
+    cd samples/McpWeatherApp/app
+    npm install
+    npm run build
+    cd ..
+    ```
+
 ::: zone-end
 ::: zone pivot="programming-language-python"  
 
@@ -169,13 +193,16 @@ The MCP Apps weather tool includes a frontend application that you must build be
     ```
 
 ::: zone-end  
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 ## Run your MCP server locally 
 ::: zone-end  
 ::: zone pivot="programming-language-csharp"
 When prompted, select **src/McpWeatherApp**. You see this prompt because there are two projects in the solution, and the other project isn't used by this article.
 ::: zone-end  
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-java"
+In a terminal window, make sure you're in the `samples/McpWeatherApp` project folder.
+::: zone-end  
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 [!INCLUDE [run-locally](../../includes/functions-mcp-run-locally.md)]
 
 ## Verify by using GitHub Copilot
@@ -204,50 +231,85 @@ You can review the code that defines the MCP Apps tools. An MCP Apps tool requir
 + A **resource** that serves the bundled HTML/JavaScript at the matching `ui://` URI.
 ::: zone-end  
 ::: zone pivot="programming-language-csharp"
-The function code for the MCP Apps weather tool is defined in the `src/McpWeatherApp` folder. The `[McpMetadata]` attribute adds UI metadata to the tool, and the `[McpResourceTrigger]` attribute serves the HTML widget:
+The function code for the MCP Apps weather tool is defined in the `src/McpWeatherApp` folder. In this function, the `[McpMetadata]` attribute adds UI metadata to the `GetWeather` tool.
 
 :::code language="csharp" source="~/functions-scenarios-custom-mcp-dotnet/src/McpWeatherApp/WeatherFunction.cs" range="48-76" :::
 
+The `[McpResourceTrigger]` attribute is applied to the `GetWeatherWidget` function, which serves the HTML widget.
+
 :::code language="csharp" source="~/functions-scenarios-custom-mcp-dotnet/src/McpWeatherApp/WeatherFunction.cs" range="34-46" :::  
 
-The `ToolMetadata` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs. The `GetWeatherWidget` function serves the bundled HTML file at that URI using `[McpResourceTrigger]`.
+The `ToolMetadata` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs.
+
+:::code language="csharp" source="~/functions-scenarios-custom-mcp-dotnet/src/McpWeatherApp/WeatherFunction.cs" range="12-18" :::
+
+The `GetWeatherWidget` function serves the bundled HTML file at that URI using `[McpResourceTrigger]`.
 
 You can view the complete project template in the [Azure Functions .NET MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-dotnet) GitHub repository.
 ::: zone-end  
 ::: zone pivot="programming-language-python"
-The function code for the MCP Apps weather tool is defined in the `src/function_app.py` file. The `metadata` parameter on `@app.mcp_tool()` adds UI metadata to the tool:
+The function code for the MCP Apps weather tool is defined in the `src/function_app.py` file. In this function, the `metadata` parameter on `@app.mcp_tool()` adds UI metadata to the `get_weather` tool.
 
 :::code language="python" source="~/functions-scenarios-custom-mcp-python/src/function_app.py" range="109-130" :::
 
-The `TOOL_METADATA` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs. The `@app.mcp_resource_trigger()` method serves the HTML widget. The `get_weather_widget` function serves the bundled HTML file at that URI using `@app.mcp_resource_trigger()`:
+The `@app.mcp_resource_trigger()` decorator is applied to the `get_weather_widget` function, which serves the HTML widget.
 
 :::code language="python" source="~/functions-scenarios-custom-mcp-python/src/function_app.py" range="64-105" :::
 
+The `TOOL_METADATA` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs.
+
+:::code language="python" source="~/functions-scenarios-custom-mcp-python/src/function_app.py" range="20-21" :::
+
+The `get_weather_widget` function serves the bundled HTML file at that URI using `@app.mcp_resource_trigger()`.
+
 You can view the complete project template in the [Azure Functions Python MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-python) GitHub repository.
 ::: zone-end   
 ::: zone pivot="programming-language-typescript"
-The function code for the MCP Apps weather tool is defined in the `src/functions/weatherMcpApp.ts` file. The `metadata` property on `app.mcpTool()` adds UI metadata to the tool, and `app.mcpResource()` serves the HTML widget:
+The function code for the MCP Apps weather tool is defined in the `src/functions/weatherMcpApp.ts` file. In this function, the `metadata` property on `app.mcpTool()` adds UI metadata to the `getWeather` tool when it's registered.
 
-:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="13-17" :::
+:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="102-110" :::
+
+The `getWeather` handler fetches weather data for a location and returns it as JSON.
 
 :::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="54-87" :::
 
-:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="102-110" :::
+The `app.mcpResource()` function registers the `getWeatherWidget` handler, which serves the HTML widget.
+
+:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="89-97" :::
+
+The `getWeatherWidget` handler reads and returns the bundled HTML file.
 
 :::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="29-52" :::
 
-:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="89-97" :::
+The `TOOL_METADATA` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs.
 
-The `TOOL_METADATA` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs. The `getWeatherWidget` handler serves the bundled HTML file at that URI when registered with `app.mcpResource()`.
+:::code language="typescript" source="~/functions-scenarios-custom-mcp-typescript/src/functions/weatherMcpApp.ts" range="13-17" :::
 
 You can view the complete project template in the [Azure Functions TypeScript MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-typescript) GitHub repository.  
 ::: zone-end  
-::: zone pivot="programming-language-csharp,programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-java"
+The function code for the MCP Apps weather tool is defined in the `samples/McpWeatherApp` folder. In this function, the `@McpMetadata` annotation adds UI metadata to the `GetWeather` tool.
+
+:::code language="java" source="~/functions-scenarios-custom-mcp-java/samples/McpWeatherApp/src/main/java/com/function/weather/WeatherFunction.java" range="98-132" :::
+
+The `@McpResourceTrigger` annotation is applied to the `GetWeatherWidget` function, which serves the HTML widget.
+
+:::code language="java" source="~/functions-scenarios-custom-mcp-java/samples/McpWeatherApp/src/main/java/com/function/weather/WeatherFunction.java" range="53-66" :::  
+
+The `TOOL_METADATA` constant declares a `ui.resourceUri` that tells the MCP host to fetch the interactive UI from `ui://weather/index.html` after the tool runs. 
+
+:::code language="java" source="~/functions-scenarios-custom-mcp-java/samples/McpWeatherApp/src/main/java/com/function/weather/WeatherFunction.java" range="29-35" ::: 
+
+The `GetWeatherWidget` function serves the bundled HTML file at that URI using `@McpResourceTrigger`.
+
+You can view the complete project template in the [Azure Functions Java MCP Server](https://github.com/Azure-Samples/remote-mcp-functions-java) GitHub repository.
+::: zone-end  
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 After verifying the MCP Apps tools locally, you can publish the project to Azure.
 
 ## Deploy to Azure
 ::: zone-end  
-::: zone pivot="programming-language-python,programming-language-typescript" 
+::: zone pivot="programming-language-java,programming-language-python,programming-language-typescript" 
 [!INCLUDE [deploy-azure](../../includes/functions-mcp-deploy-azure.md)]
 ::: zone-end
 
@@ -274,15 +336,17 @@ This project is configured to use `azd` to deploy this project to a new function
    | _Azure subscription_ | Subscription in which your resources are created. |
    | _Azure location_ | Azure region in which to create the resource group that contains the new Azure resources. Only regions that currently support the Flex Consumption plan are shown. |
    | _vnetEnabled_ | `False` to skip creating virtual network resources, which simplifies the deployment. |
-    When prompted, pick your subscription, an Azure region for the resources, and choose `false` to skip creating virtual network resources to simplify the deployment.
+
+   When prompted, pick your subscription, an Azure region for the resources, and choose `false` to skip creating virtual network resources to simplify the deployment.
 
 1. Run the `azd deploy` command to deploy the `weather` app to Azure:
 
     ```console
     azd deploy --service weather
     ```
-::: zone-end
 
+::: zone-end
+::: zone pivot="programming-language-csharp,programming-language-java,programming-language-python,programming-language-typescript" 
 ## Connect to your remote MCP server
 
 [!INCLUDE [connect-remote](../../includes/functions-mcp-connect-remote.md)]
