Add Java Spring AI MCP for AgentCore Runtime Tutorials

01-tutorials/01-AgentCore-runtime/07-hosting-java-spring-ai-mcp/.gitattributes

@@ -0,0 +1,3 @@
+/gradlew text eol=lf
+*.bat text eol=crlf
+*.jar binary

01-tutorials/01-AgentCore-runtime/07-hosting-java-spring-ai-mcp/.gitignore

@@ -0,0 +1,43 @@
+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/
+
+### Kotlin ###
+.kotlin
+/infra/cdk.out/
+/infra/.venv/
+/infra/__pycache__/

01-tutorials/01-AgentCore-runtime/07-hosting-java-spring-ai-mcp/README.md

@@ -0,0 +1,96 @@
+# Hosting Java Spring AI MCP Servers
+
+## Overview
+
+In this tutorial we will learn how to host a Java Spring AI MCP server using Amazon Bedrock AgentCore Runtime.
+
+### Tutorial Details
+
+| Information         | Details                                                   |
+|:--------------------|:----------------------------------------------------------|
+| Tutorial type       | Hosting Tools                                             |
+| Tool type           | MCP server                                                |
+| Tutorial components | Hosting a Java Spring AI MCP server on AgentCore Runtime. |
+| Tutorial vertical   | Cross-vertical                                            |
+| Example complexity  | Easy                                                      |
+| SDK used            | Java Spring AI                                            |
+
+### Tutorial Architecture
+
+This Java Spring AI MCP server has two pieces:
+- A Spring AI MCP server with a single `add` tool
+- A configuration file which sets the MCP server protocol and the server port
+
+The Java source code for the MCP server is in the `src/main/java/com/example/DemoApplication.java` file and uses the `@McpTool` annotation to expose the `add` tool.
+The configuration file is in the `src/main/resources/application.properties` file and sets the MCP server protocol to `stateless` and the port to `8000`.
+
+## Run Locally
+
+1. Run the app: `./gradlew bootRun`
+1. Test the MCP server with [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
+
+## Run on AgentCore Runtime
+
+Note: To build the container image you need to be on a ARM64 machine. If you are on an AMD64 machine, you should build the container image in a Code Build process (using ARM64 build machines) or in an ARM64 virtual machine.
+
+Prereqs:
+- AWS CLI installed and authenticated
+- Docker installed
+- [Create ECR Repo](https://us-east-1.console.aws.amazon.com/ecr/private-registry/repositories/create?region=us-east-1)
+- [Auth `docker` to ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html)
+
+Create and push the image to ECR:
+```
+export ECR_REPO=<your account id>.dkr.ecr.us-east-1.amazonaws.com/<your repo path>
+
+./gradlew bootBuildImage --imageName=$ECR_REPO
+
+docker push $ECR_REPO
+```
+
+Now create an AgentCore Runtime agent from the container image:
+1. https://us-east-1.console.aws.amazon.com/bedrock-agentcore/agents/create
+2. Select the image you just pushed, in **Inbound Auth** select MCP and **Use IAM permissions**, click "Host agent"
+3. Once the agent has been created, use the Agent Sandbox to test the agent with these inputs (MCP protocol):
+    ```json
+    {
+      "jsonrpc": "2.0",
+      "id": 1,
+      "method": "initialize",
+      "params": {
+        "protocolVersion": "2024-11-05",
+        "capabilities": {
+          "tools": {
+          }
+        },
+        "clientInfo": {
+          "name": "ExampleClient",
+          "title": "Example Client",
+          "version": "1.0.0"
+        }
+      }
+    }
+    ```
+
+    ```json
+    {
+      "jsonrpc": "2.0",
+      "id": 1,
+      "method": "tools/list"
+    }
+    ```
+
+    ```json
+    {
+      "jsonrpc": "2.0",
+      "id": 2,
+      "method": "tools/call",
+      "params": {
+        "name": "add",
+        "arguments": {
+          "a": 1,
+          "b": 2
+        }
+      }
+    }
+    ```

01-tutorials/01-AgentCore-runtime/07-hosting-java-spring-ai-mcp/build.gradle.kts

@@ -0,0 +1,22 @@
+plugins {
+    java
+    id("org.springframework.boot") version "3.5.7"
+    id("io.spring.dependency-management") version "1.1.7"
+}
+
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+dependencies {
+    implementation("org.springframework.ai:spring-ai-starter-mcp-server-webflux")
+    developmentOnly("org.springframework.boot:spring-boot-devtools")
+}
+
+dependencyManagement {
+    imports {
+        mavenBom("org.springframework.ai:spring-ai-bom:1.1.0")
+    }
+}

01-tutorials/01-AgentCore-runtime/07-hosting-java-spring-ai-mcp/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists