diff --git a/mcp.weather.log b/mcp.weather.log new file mode 100644 index 0000000..f4ae0ed --- /dev/null +++ b/mcp.weather.log @@ -0,0 +1,4 @@ +2025-03-17T21:20:53.178+01:00 INFO 52952 --- [main] o.s.a.m.s.server.McpServerApplication : Starting McpServerApplication using Java 17.0.12 with PID 52952 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/weather/manual-webflux-server/target/classes started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) +2025-03-17T21:20:53.179+01:00 INFO 52952 --- [main] o.s.a.m.s.server.McpServerApplication : No active profile set, falling back to 1 default profile: "default" +2025-03-17T21:20:53.788+01:00 INFO 52952 --- [main] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port 8080 (http) +2025-03-17T21:20:53.797+01:00 INFO 52952 --- [main] o.s.a.m.s.server.McpServerApplication : Started McpServerApplication in 0.782 seconds (process running for 0.909) diff --git a/model-context-protocol/book-library/manual-servlet-server/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/book-library/manual-servlet-server/.mvn/wrapper/maven-wrapper.properties deleted file mode 100644 index d58dfb7..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/.mvn/wrapper/maven-wrapper.properties +++ /dev/null @@ -1,19 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -wrapperVersion=3.3.2 -distributionType=only-script -distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip diff --git a/model-context-protocol/book-library/manual-servlet-server/README.md b/model-context-protocol/book-library/manual-servlet-server/README.md deleted file mode 100644 index 1fadaac..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/README.md +++ /dev/null @@ -1,222 +0,0 @@ -# Spring AI MCP Servlet SSE Server Sample Project - -This sample project demonstrates the usage of the Spring AI Model Context Protocol (MCP) implementation with HttpServletSseServerTransport. It showcases how to create and use MCP servers with Servlet-based SSE transport and various capabilities. - -## Overview - -The sample provides: -- Two transport mode implementations: - - HttpServletSseServerTransport for SSE (Server-Sent Events) - - StdioServerTransport for standard I/O -- Server capabilities: - - Tools support with list changes notifications - - Resources support with list changes notifications (no subscribe support) - - Prompts support with list changes notifications -- Sample implementations: - - Two MCP tools: Weather and Calculator - - One MCP resource: System Information - - One MCP prompt: Greeting - -## Building the Project - -```bash -./mvnw clean install -DskipTests -``` - -## Running the Server - -The server can be started in two transport modes, controlled by the `transport.mode` property: - -### Stdio Mode (Default) - -```bash -java -Dtransport.mode=stdio -jar target/mcp-servlet-server-0.0.1-SNAPSHOT.jar -``` - -The Stdio mode server is automatically started by the client - no explicit server startup is needed. -But you have to build the server jar first: `./mvnw clean install -DskipTests`. - -In Stdio mode the server must not emit any messages/logs to the console (e.g. standard out) but the JSON messages produced by the server. - -### SSE Mode with HttpServletSseServerTransport -```bash -java -Dtransport.mode=sse -jar target/mcp-servlet-server-0.0.1-SNAPSHOT.jar -``` - -The HttpServletSseServerTransport provides two endpoints: -- SSE endpoint at `/sse` - For server-to-client events -- Message endpoint at `/mcp/message` - For client-to-server messages - -## Sample Clients - -The project includes example clients for both transport modes: - -### Stdio Client (ClientStdio.java) -```java -var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-jar", - "target/mcp-servlet-server-0.0.1-SNAPSHOT.jar") - .build(); - -var transport = new StdioClientTransport(stdioParams); -var client = McpClient.using(transport).sync(); -``` - -### SSE Client (HttpClientSse.java) -```java -var transport = new HttpClientSseClientTransport("http://localhost:8080"); -var client = McpClient.using(transport).sync(); -``` - -## Available Tools - -### Weather Tool -- Name: `weather` -- Description: Weather forecast tool by location -- Parameters: - - `city`: String - The city to get weather for -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -``` - -### Calculator Tool -- Name: `calculator` -- Description: Performs basic arithmetic operations -- Parameters (JSON Schema): - ```json - { - "operation": { - "type": "string", - "enum": ["add", "subtract", "multiply", "divide"], - "description": "The arithmetic operation to perform" - }, - "a": { - "type": "number", - "description": "First operand" - }, - "b": { - "type": "number", - "description": "Second operand" - } - } - ``` -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("calculator", - Map.of("operation", "multiply", "a", 2.0, "b", 3.0)) -); -``` - -## Available Resources - -### System Information Resource -- URI: `system://info` -- Description: Provides basic system information including Java version, OS, etc. -- MIME Type: application/json -- Returns: JSON object containing: javaVersion, osName, osVersion, osArch, processors, timestamp - -## Available Prompts - -### Greeting Prompt -- Name: `greeting` -- Description: A friendly greeting prompt -- Parameters: - - `name`: String (required) - The name to greet -- Returns: A personalized greeting message from an assistant - -## Client Usage Example - -```java -// Initialize client -client.initialize(); - -// Test connection -client.ping(); - -// List available tools -ListToolsResult tools = client.listTools(); -System.out.println("Available tools: " + tools); - -// Call weather tool -CallToolResult weather = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -System.out.println("Weather: " + weather); - -// Access system info resource -ReadResourceResult sysInfo = client.readResource( - new ReadResourceRequest("system://info") -); -System.out.println("System Info: " + sysInfo); - -// Use greeting prompt -GetPromptResult greeting = client.getPrompt( - new GetPromptRequest("greeting", Map.of("name", "John")) -); -System.out.println("Greeting: " + greeting); - -// Close client -client.closeGracefully(); -``` - -## Server Configuration Example - -```java -@Configuration -@EnableWebMvc -public class McpServerConfig implements WebMvcConfigurer { - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public HttpServletSseServerTransport webSseServerTransport() { - return new HttpServletSseServerTransport(new ObjectMapper(), "/mcp/message"); - } - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public ServletRegistrationBean customServletBean(HttpServletSseServerTransport servlet) { - return new ServletRegistrationBean(servlet, "/sse", "/mcp/message"); - } - - @Bean - public McpAsyncServer mcpServer(ServerMcpTransport transport) { - // Configure server capabilities - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // Resource support with list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .build(); - - // Create and configure the server - return McpServer.using(transport) - .serverInfo("MCP Demo Server", "1.0.0") - .capabilities(capabilities) - // Add your tools, resources, and prompts here - .async(); - } -} -``` - -## Configuration - -The application can be configured through `application.properties`: - -- `transport.mode`: Transport mode to use (stdio/sse) -- `server.port`: Server port for SSE mode (default: 8080) -- Various logging configurations are available for debugging - -## Implementation Details - -The sample demonstrates: -- Using HttpServletSseServerTransport for SSE-based communication -- Creating an MCP server with custom tools, resources, and prompts -- Configuring different transport modes -- Implementing tool handlers with JSON schema validation -- Resource implementations with dynamic content generation -- Prompt implementations with parameter handling -- Error handling and response formatting -- Synchronous client usage patterns diff --git a/model-context-protocol/book-library/manual-servlet-server/mvnw b/model-context-protocol/book-library/manual-servlet-server/mvnw deleted file mode 100755 index 19529dd..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/mvnw +++ /dev/null @@ -1,259 +0,0 @@ -#!/bin/sh -# ---------------------------------------------------------------------------- -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# ---------------------------------------------------------------------------- - -# ---------------------------------------------------------------------------- -# Apache Maven Wrapper startup batch script, version 3.3.2 -# -# Optional ENV vars -# ----------------- -# JAVA_HOME - location of a JDK home dir, required when download maven via java source -# MVNW_REPOURL - repo url base for downloading maven distribution -# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output -# ---------------------------------------------------------------------------- - -set -euf -[ "${MVNW_VERBOSE-}" != debug ] || set -x - -# OS specific support. -native_path() { printf %s\\n "$1"; } -case "$(uname)" in -CYGWIN* | MINGW*) - [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" - native_path() { cygpath --path --windows "$1"; } - ;; -esac - -# set JAVACMD and JAVACCMD -set_java_home() { - # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched - if [ -n "${JAVA_HOME-}" ]; then - if [ -x "$JAVA_HOME/jre/sh/java" ]; then - # IBM's JDK on AIX uses strange locations for the executables - JAVACMD="$JAVA_HOME/jre/sh/java" - JAVACCMD="$JAVA_HOME/jre/sh/javac" - else - JAVACMD="$JAVA_HOME/bin/java" - JAVACCMD="$JAVA_HOME/bin/javac" - - if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then - echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 - echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 - return 1 - fi - fi - else - JAVACMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v java - )" || : - JAVACCMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v javac - )" || : - - if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then - echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 - return 1 - fi - fi -} - -# hash string like Java String::hashCode -hash_string() { - str="${1:-}" h=0 - while [ -n "$str" ]; do - char="${str%"${str#?}"}" - h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) - str="${str#?}" - done - printf %x\\n $h -} - -verbose() { :; } -[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } - -die() { - printf %s\\n "$1" >&2 - exit 1 -} - -trim() { - # MWRAPPER-139: - # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. - # Needed for removing poorly interpreted newline sequences when running in more - # exotic environments such as mingw bash on Windows. - printf "%s" "${1}" | tr -d '[:space:]' -} - -# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties -while IFS="=" read -r key value; do - case "${key-}" in - distributionUrl) distributionUrl=$(trim "${value-}") ;; - distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; - esac -done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties" -[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties" - -case "${distributionUrl##*/}" in -maven-mvnd-*bin.*) - MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ - case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in - *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; - :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; - :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; - :Linux*x86_64*) distributionPlatform=linux-amd64 ;; - *) - echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 - distributionPlatform=linux-amd64 - ;; - esac - distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" - ;; -maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; -*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; -esac - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" -distributionUrlName="${distributionUrl##*/}" -distributionUrlNameMain="${distributionUrlName%.*}" -distributionUrlNameMain="${distributionUrlNameMain%-bin}" -MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" -MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" - -exec_maven() { - unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : - exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" -} - -if [ -d "$MAVEN_HOME" ]; then - verbose "found existing MAVEN_HOME at $MAVEN_HOME" - exec_maven "$@" -fi - -case "${distributionUrl-}" in -*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; -*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; -esac - -# prepare tmp dir -if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then - clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } - trap clean HUP INT TERM EXIT -else - die "cannot create temp dir" -fi - -mkdir -p -- "${MAVEN_HOME%/*}" - -# Download and Install Apache Maven -verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -verbose "Downloading from: $distributionUrl" -verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -# select .zip or .tar.gz -if ! command -v unzip >/dev/null; then - distributionUrl="${distributionUrl%.zip}.tar.gz" - distributionUrlName="${distributionUrl##*/}" -fi - -# verbose opt -__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' -[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v - -# normalize http auth -case "${MVNW_PASSWORD:+has-password}" in -'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; -has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; -esac - -if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then - verbose "Found wget ... using wget" - wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" -elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then - verbose "Found curl ... using curl" - curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" -elif set_java_home; then - verbose "Falling back to use Java to download" - javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" - targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" - cat >"$javaSource" <<-END - public class Downloader extends java.net.Authenticator - { - protected java.net.PasswordAuthentication getPasswordAuthentication() - { - return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); - } - public static void main( String[] args ) throws Exception - { - setDefault( new Downloader() ); - java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); - } - } - END - # For Cygwin/MinGW, switch paths to Windows format before running javac and java - verbose " - Compiling Downloader.java ..." - "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" - verbose " - Running Downloader.java ..." - "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" -fi - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -if [ -n "${distributionSha256Sum-}" ]; then - distributionSha256Result=false - if [ "$MVN_CMD" = mvnd.sh ]; then - echo "Checksum validation is not supported for maven-mvnd." >&2 - echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - elif command -v sha256sum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - elif command -v shasum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - else - echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2 - echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - fi - if [ $distributionSha256Result = false ]; then - echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 - echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 - exit 1 - fi -fi - -# unzip and move -if command -v unzip >/dev/null; then - unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" -else - tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" -fi -printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url" -mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" - -clean || : -exec_maven "$@" diff --git a/model-context-protocol/book-library/manual-servlet-server/mvnw.cmd b/model-context-protocol/book-library/manual-servlet-server/mvnw.cmd deleted file mode 100644 index b150b91..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/mvnw.cmd +++ /dev/null @@ -1,149 +0,0 @@ -<# : batch portion -@REM ---------------------------------------------------------------------------- -@REM Licensed to the Apache Software Foundation (ASF) under one -@REM or more contributor license agreements. See the NOTICE file -@REM distributed with this work for additional information -@REM regarding copyright ownership. The ASF licenses this file -@REM to you under the Apache License, Version 2.0 (the -@REM "License"); you may not use this file except in compliance -@REM with the License. You may obtain a copy of the License at -@REM -@REM http://www.apache.org/licenses/LICENSE-2.0 -@REM -@REM Unless required by applicable law or agreed to in writing, -@REM software distributed under the License is distributed on an -@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -@REM KIND, either express or implied. See the License for the -@REM specific language governing permissions and limitations -@REM under the License. -@REM ---------------------------------------------------------------------------- - -@REM ---------------------------------------------------------------------------- -@REM Apache Maven Wrapper startup batch script, version 3.3.2 -@REM -@REM Optional ENV vars -@REM MVNW_REPOURL - repo url base for downloading maven distribution -@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output -@REM ---------------------------------------------------------------------------- - -@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) -@SET __MVNW_CMD__= -@SET __MVNW_ERROR__= -@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% -@SET PSModulePath= -@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( - IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) -) -@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% -@SET __MVNW_PSMODULEP_SAVE= -@SET __MVNW_ARG0_NAME__= -@SET MVNW_USERNAME= -@SET MVNW_PASSWORD= -@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*) -@echo Cannot start maven from wrapper >&2 && exit /b 1 -@GOTO :EOF -: end batch / begin powershell #> - -$ErrorActionPreference = "Stop" -if ($env:MVNW_VERBOSE -eq "true") { - $VerbosePreference = "Continue" -} - -# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties -$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl -if (!$distributionUrl) { - Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" -} - -switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { - "maven-mvnd-*" { - $USE_MVND = $true - $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" - $MVN_CMD = "mvnd.cmd" - break - } - default { - $USE_MVND = $false - $MVN_CMD = $script -replace '^mvnw','mvn' - break - } -} - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -if ($env:MVNW_REPOURL) { - $MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" } - $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')" -} -$distributionUrlName = $distributionUrl -replace '^.*/','' -$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' -$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain" -if ($env:MAVEN_USER_HOME) { - $MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain" -} -$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' -$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" - -if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { - Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" - Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" - exit $? -} - -if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { - Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" -} - -# prepare tmp dir -$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile -$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" -$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null -trap { - if ($TMP_DOWNLOAD_DIR.Exists) { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } - } -} - -New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null - -# Download and Install Apache Maven -Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -Write-Verbose "Downloading from: $distributionUrl" -Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -$webclient = New-Object System.Net.WebClient -if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { - $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) -} -[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 -$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum -if ($distributionSha256Sum) { - if ($USE_MVND) { - Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." - } - Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash - if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { - Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." - } -} - -# unzip and move -Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null -Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null -try { - Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null -} catch { - if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { - Write-Error "fail to move MAVEN_HOME" - } -} finally { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } -} - -Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/model-context-protocol/book-library/manual-servlet-server/pom.xml b/model-context-protocol/book-library/manual-servlet-server/pom.xml deleted file mode 100644 index 2394605..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/pom.xml +++ /dev/null @@ -1,76 +0,0 @@ - - - 4.0.0 - - org.springframework.boot - spring-boot-starter-parent - 3.3.6 - - - - com.example - mcp-servlet-server - 0.0.1-SNAPSHOT - - Spring AI MCP Servlet Server Sample - Sample application demonstrating MCP Servlet server usage - - - 1.0.0-SNAPSHOT - - - - - - org.springframework.ai - spring-ai-bom - ${sprign-ai.version} - pom - import - - - - - - - org.springframework.ai - spring-ai-mcp - - - - org.springframework.boot - spring-boot-starter-web - - - - - - - org.springframework.boot - spring-boot-maven-plugin - - - - - - - spring-milestones - Spring Milestones - https://repo.spring.io/milestone - - false - - - - spring-snapshots - Spring Snapshots - https://repo.spring.io/snapshot - - false - - - - - \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServerConfig.java b/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServerConfig.java deleted file mode 100644 index 67f6d37..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServerConfig.java +++ /dev/null @@ -1,147 +0,0 @@ -package org.springframework.ai.mcp.sample.servlet.server; - -import java.util.List; -import java.util.Map; -import java.util.function.Function; - -import com.fasterxml.jackson.databind.ObjectMapper; -import io.modelcontextprotocol.server.McpServer; -import io.modelcontextprotocol.server.McpServerFeatures.SyncPromptRegistration; -import io.modelcontextprotocol.server.McpServerFeatures.SyncResourceRegistration; -import io.modelcontextprotocol.server.McpServerFeatures.SyncToolRegistration; -import io.modelcontextprotocol.server.McpSyncServer; -import io.modelcontextprotocol.server.transport.HttpServletSseServerTransport; -import io.modelcontextprotocol.server.transport.StdioServerTransport; -import io.modelcontextprotocol.spec.McpSchema; -import io.modelcontextprotocol.spec.McpSchema.GetPromptResult; -import io.modelcontextprotocol.spec.McpSchema.PromptMessage; -import io.modelcontextprotocol.spec.McpSchema.Role; -import io.modelcontextprotocol.spec.McpSchema.TextContent; -import io.modelcontextprotocol.spec.ServerMcpTransport; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import org.springframework.ai.mcp.McpToolUtils; -import org.springframework.ai.tool.ToolCallback; -import org.springframework.ai.tool.ToolCallbacks; -import org.springframework.ai.tool.function.FunctionToolCallback; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.boot.web.servlet.ServletRegistrationBean; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; -import org.springframework.web.servlet.config.annotation.EnableWebMvc; -import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; - -@Configuration -@EnableWebMvc -public class McpServerConfig implements WebMvcConfigurer { - - private static final Logger logger = LoggerFactory.getLogger(McpServerConfig.class); - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public HttpServletSseServerTransport webMvcSseServerTransport() { - return new HttpServletSseServerTransport(new ObjectMapper(), "/mcp/message"); - } - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public ServletRegistrationBean customServletBean(HttpServletSseServerTransport servlet) { - return new ServletRegistrationBean(servlet); - } - - // STDIO transport - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "stdio") - public StdioServerTransport stdioServerTransport() { - return new StdioServerTransport(); - } - - public static record ToUpperCaseInput(String input) { - } - - @Bean - public McpSyncServer mcpServer(ServerMcpTransport transport, OpenLibrary openLibrary) { // @formatter:off - - // Configure server capabilities with resource support - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // No subscribe support, but list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .logging() // Logging support - .build(); - - // Create the server with both tool and resource capabilities - var server = McpServer.sync(transport) - .serverInfo("MCP Demo Servlet Server", "1.0.0") - .capabilities(capabilities) - .resources(systemInfoResourceRegistration()) - .prompts(greetingPromptRegistration()) - .tools( - McpToolUtils.toSyncToolRegistration( - FunctionToolCallback.builder("toUpperCase", (Function) s -> s.input().toUpperCase()) - .description("To upper case") - .inputType(ToUpperCaseInput.class) - .build())) - .tools(openLibraryToolRegistrations(openLibrary)) - .build(); - return server; // @formatter:on - } // @formatter:on - - public static List openLibraryToolRegistrations(OpenLibrary openLibrary) { - ToolCallback[] tools = ToolCallbacks.from(openLibrary); - return McpToolUtils.toSyncToolRegistration(tools); - } - - private static SyncResourceRegistration systemInfoResourceRegistration() { - - // Create a resource registration for system information - var systemInfoResource = new McpSchema.Resource( // @formatter:off - "system://info", - "System Information", - "Provides basic system information including Java version, OS, etc.", - "application/json", null - ); - - var resourceRegistration = new SyncResourceRegistration(systemInfoResource, (request) -> { - try { - var systemInfo = Map.of( - "javaVersion", System.getProperty("java.version"), - "osName", System.getProperty("os.name"), - "osVersion", System.getProperty("os.version"), - "osArch", System.getProperty("os.arch"), - "processors", Runtime.getRuntime().availableProcessors(), - "timestamp", System.currentTimeMillis()); - - String jsonContent = new ObjectMapper().writeValueAsString(systemInfo); - - return new McpSchema.ReadResourceResult( - List.of(new McpSchema.TextResourceContents(request.uri(), "application/json", jsonContent))); - } - catch (Exception e) { - throw new RuntimeException("Failed to generate system info", e); - } - }); // @formatter:on - - return resourceRegistration; - } - - private static SyncPromptRegistration greetingPromptRegistration() { - - var prompt = new McpSchema.Prompt("greeting", "A friendly greeting prompt", - List.of(new McpSchema.PromptArgument("name", "The name to greet", true))); - - return new SyncPromptRegistration(prompt, getPromptRequest -> { - - String nameArgument = (String) getPromptRequest.arguments().get("name"); - if (nameArgument == null) { - nameArgument = "friend"; - } - - var userMessage = new PromptMessage(Role.USER, - new TextContent("Hello " + nameArgument + "! How can I assist you today?")); - - return new GetPromptResult("A personalized greeting message", List.of(userMessage)); - }); - } -} diff --git a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServletServerApplication.java b/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServletServerApplication.java deleted file mode 100644 index 146dc7f..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/McpServletServerApplication.java +++ /dev/null @@ -1,13 +0,0 @@ -package org.springframework.ai.mcp.sample.servlet.server; - -import org.springframework.boot.SpringApplication; -import org.springframework.boot.autoconfigure.SpringBootApplication; - -@SpringBootApplication -public class McpServletServerApplication { - - public static void main(String[] args) { - SpringApplication.run(McpServletServerApplication.class, args); - } - -} diff --git a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/OpenLibrary.java b/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/OpenLibrary.java deleted file mode 100644 index 47bb548..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/main/java/org/springframework/ai/mcp/sample/servlet/server/OpenLibrary.java +++ /dev/null @@ -1,78 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.servlet.server; - -import java.util.List; -import java.util.Map; - -import org.springframework.ai.tool.annotation.Tool; -import org.springframework.stereotype.Service; -import org.springframework.web.client.RestClient; - -/** - * @author Christian Tzolov - */ -@Service -public class OpenLibrary { - - private RestClient restClient; - - public OpenLibrary(RestClient.Builder restClientBuilder) { - this.restClient = restClientBuilder.baseUrl("https://openlibrary.org").build(); - } - - public record Books(Integer numFound, Integer start, Boolean numFoundExact, List> docs) { - } - - public record Book(List isbn, String title, List authorName) { - } - - @Tool(description = "Search for books by title") - public List getBooks(String title) { - Books books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search.json").queryParam("q", title).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream() - .map(doc -> new Book((List) doc.get("isbn"), (String) doc.get("title"), - (List) doc.get("author_name"))) - .toList(); - } - - @Tool(description = "Search for books by author") - public List getBookTitlesByAuthor(String authorName) { - var books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search/authors.json").queryParam("q", authorName).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream().map(doc -> (String) doc.get("top_work")).toList(); - } - - public static void main(String[] args) { - OpenLibrary openLibrary = new OpenLibrary(RestClient.builder()); - List books = openLibrary.getBooks("Spring Framework"); - System.out.println(books); - List booksByAuthor = openLibrary.getBookTitlesByAuthor("Craig Walls"); - System.out.println(booksByAuthor); - } - -} diff --git a/model-context-protocol/book-library/manual-servlet-server/src/main/resources/application.properties b/model-context-protocol/book-library/manual-servlet-server/src/main/resources/application.properties deleted file mode 100644 index c4bd128..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/main/resources/application.properties +++ /dev/null @@ -1,10 +0,0 @@ -spring.main.web-application-type=SERVLET - -# NOTE: You must disable the banner and the console logging -# to allow the STDIO transport to work !!! -spring.main.banner-mode=off -logging.pattern.console= - -transport.mode=sse - -logging.file.name=mcp.servlet-server.log \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/ClientStdio.java b/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/ClientStdio.java deleted file mode 100644 index 6c7d857..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/ClientStdio.java +++ /dev/null @@ -1,39 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.servlet.client; - -import io.modelcontextprotocol.client.transport.ServerParameters; -import io.modelcontextprotocol.client.transport.StdioClientTransport; - -/** - * With stdio transport, the MCP server is automatically started by the client. But you - * have to build the server jar first: 
./mvnw clean install -DskipTests
- */ -public class ClientStdio { - - public static void main(String[] args) { - - var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-Dspring.main.web-application-type=none", "-jar", - "model-context-protocol/book-library/manual-servlet-server/target/mcp-servlet-server-0.0.1-SNAPSHOT.jar") - .build(); - - var transport = new StdioClientTransport(stdioParams); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/HttpClientSse.java b/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/HttpClientSse.java deleted file mode 100644 index 44e841d..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/HttpClientSse.java +++ /dev/null @@ -1,31 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.servlet.client; - -import io.modelcontextprotocol.client.transport.HttpClientSseClientTransport; - -/** - * @author Christian Tzolov - */ -public class HttpClientSse { - - public static void main(String[] args) { - var transport = new HttpClientSseClientTransport("http://localhost:8080"); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/SampleClient.java b/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/SampleClient.java deleted file mode 100644 index 9d37bd4..0000000 --- a/model-context-protocol/book-library/manual-servlet-server/src/test/java/org/springframework/ai/mcp/sample/servlet/client/SampleClient.java +++ /dev/null @@ -1,81 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.servlet.client; - -import java.util.Map; - -import io.modelcontextprotocol.client.McpClient; -import io.modelcontextprotocol.spec.ClientMcpTransport; -import io.modelcontextprotocol.spec.McpSchema.CallToolResult; -import io.modelcontextprotocol.spec.McpSchema.ListPromptsResult; -import io.modelcontextprotocol.spec.McpSchema.ListToolsResult; -import io.modelcontextprotocol.spec.McpSchema.CallToolRequest; -import io.modelcontextprotocol.spec.McpSchema.GetPromptRequest; -import io.modelcontextprotocol.spec.McpSchema.ReadResourceRequest; - - -/** - * @author Christian Tzolov - */ - -public class SampleClient { - - private final ClientMcpTransport transport; - - public SampleClient(ClientMcpTransport transport) { - this.transport = transport; - } - - public void run() { - - var client = McpClient.sync(this.transport).build(); - - client.initialize(); - - client.ping(); - - // List and demonstrate tools - ListToolsResult toolsList = client.listTools(); - System.out.println("Available Tools = " + toolsList); - - CallToolResult upperCaseResult = client - .callTool(new CallToolRequest("toUpperCase", Map.of("input", "accountName"))); - System.out.println("Upper case Response = " + upperCaseResult); - - CallToolResult books = client.callTool(new CallToolRequest("getBooks", Map.of("title", "Spring Framework"))); - System.out.println("Books Response = " + books); - - // List and demonstrate resources - var resourcesList = client.listResources(); - System.out.println("\nAvailable Resources = " + resourcesList); - - // Read the system info resource - var systemInfo = client.readResource(new ReadResourceRequest("system://info")); - System.out.println("System Info = " + systemInfo); - - // List and demonstrate prompts - ListPromptsResult promptsList = client.listPrompts(); - System.out.println("\nAvailable Prompts = " + promptsList); - - // Try the greeting prompt - var greetingResponse = client.getPrompt(new GetPromptRequest("greeting", Map.of("name", "Spring"))); - System.out.println("Greeting Response = " + greetingResponse); - - client.closeGracefully(); - - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/.flattened-pom.xml b/model-context-protocol/book-library/manual-webflux-server/.flattened-pom.xml deleted file mode 100644 index 74d4c41..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/.flattened-pom.xml +++ /dev/null @@ -1,48 +0,0 @@ - - - 4.0.0 - org.springframework.experimental - spring-ai-mcp-sample - 0.5.0-SNAPSHOT - Spring AI MCP Sample - Sample Spring Boot application demonstrating MCP server usage - - Spring Framework - https://spring.io - - - - Apache 2.0 - https://www.apache.org/licenses/LICENSE-2.0.txt - repo - - - - - Christian Tzolov - - - Dariusz Jędrzejczyk - - - - - org.springframework.experimental - mcp-webflux-sse-transport - 0.5.0-SNAPSHOT - compile - - - org.springframework.experimental - spring-ai-mcp - 0.5.0-SNAPSHOT - compile - - - org.springframework.boot - spring-boot-starter-webflux - 3.4.1 - compile - - - \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-webflux-server/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/book-library/manual-webflux-server/.mvn/wrapper/maven-wrapper.properties deleted file mode 100644 index d58dfb7..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/.mvn/wrapper/maven-wrapper.properties +++ /dev/null @@ -1,19 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -wrapperVersion=3.3.2 -distributionType=only-script -distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip diff --git a/model-context-protocol/book-library/manual-webflux-server/README.md b/model-context-protocol/book-library/manual-webflux-server/README.md deleted file mode 100644 index 619a75f..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/README.md +++ /dev/null @@ -1,257 +0,0 @@ -# Spring AI MCP Sample Project - -This sample project demonstrates the usage of the Spring AI Model Context Protocol (MCP) implementation. It showcases how to create and use MCP servers and clients with different transport modes and capabilities. - -## Overview - -The sample provides: -- Two transport mode implementations: Stdio and SSE (Server-Sent Events) -- Server capabilities: - - Tools support with list changes notifications - - Resources support with list changes notifications (no subscribe support) - - Prompts support with list changes notifications -- Sample implementations: - - Two MCP tools: Weather and Calculator - - One MCP resource: System Information - - One MCP prompt: Greeting - -## Building the Project - -```bash -./mvnw clean package -``` - -## Running the Server - -The server can be started in two transport modes, controlled by the `transport.mode` property: - -### Stdio Mode (Default) - -```bash -java -Dtransport.mode=stdio -jar model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar -``` - -The Stdio mode server is automatically started by the client - no explicit server startup is needed. -But you have to build the server jar first: `./mvnw clean install -DskipTests`. - -In Stdio mode the server must not emit any messages/logs to the console (e.g. standard out) but the JSON messages produced by the server. - -### SSE Mode -```bash -java -Dtransport.mode=sse -jar model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar -``` - -## Sample Clients - -The project includes example clients for both transport modes: - -### Stdio Client (ClientStdio.java) -```java -var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-jar", - "model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar") - .build(); - -var transport = new StdioClientTransport(stdioParams); -var client = McpClient.using(transport).sync(); -``` - -### SSE Client (ClientWebFluxSse.java) -```java -var transport = new SseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); -var client = McpClient.using(transport).sync(); -``` - -## Available Tools - -### Weather Tool -- Name: `weather` -- Description: Weather forecast tool by location -- Parameters: - - `city`: String - The city to get weather for -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -``` - -### Calculator Tool -- Name: `calculator` -- Description: Performs basic arithmetic operations -- Parameters (JSON Schema): - ```json - { - "operation": { - "type": "string", - "enum": ["add", "subtract", "multiply", "divide"], - "description": "The arithmetic operation to perform" - }, - "a": { - "type": "number", - "description": "First operand" - }, - "b": { - "type": "number", - "description": "Second operand" - } - } - ``` -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("calculator", - Map.of("operation", "multiply", "a", 2.0, "b", 3.0)) -); -``` - -## Available Resources - -### System Information Resource -- URI: `system://info` -- Description: Provides basic system information including Java version, OS, etc. -- MIME Type: application/json -- Returns: JSON object containing: javaVersion, osName, osVersion, osArch, processors, timestamp - -## Available Prompts - -### Greeting Prompt -- Name: `greeting` -- Description: A friendly greeting prompt -- Parameters: - - `name`: String (required) - The name to greet -- Returns: A personalized greeting message from an assistant - -## Client Usage Example - -```java -// Initialize client -client.initialize(); - -// Test connection -client.ping(); - -// List available tools -ListToolsResult tools = client.listTools(); -System.out.println("Available tools: " + tools); - -// Call weather tool -CallToolResult weather = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -System.out.println("Weather: " + weather); - -// Call calculator tool -CallToolResult calc = client.callTool( - new CallToolRequest("calculator", - Map.of("operation", "multiply", "a", 2.0, "b", 3.0)) -); -System.out.println("Calculation: " + calc); - -// Access system info resource -ReadResourceResult sysInfo = client.readResource( - new ReadResourceRequest("system://info") -); -System.out.println("System Info: " + sysInfo); - -// Use greeting prompt -GetPromptResult greeting = client.getPrompt( - new GetPromptRequest("greeting", Map.of("name", "John")) -); -System.out.println("Greeting: " + greeting); - -// Close client -client.closeGracefully(); -``` - -## Server Usage Example - -```java -@Configuration -public class CustomMcpServerConfig { - @Bean - public McpAsyncServer mcpServer(McpTransport transport) { - // Configure server capabilities - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // Resource support with list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .build(); - - // Create custom tool - var customTool = new ToolRegistration( - new McpSchema.Tool("custom-tool", "Description", Map.of("param", "String")), - (arguments) -> { - String param = (String) arguments.get("param"); - return new CallToolResult( - List.of(new TextContent("Result: " + param)), - false - ); - } - ); - - // Create custom resource - var customResource = new ResourceRegistration( - new McpSchema.Resource( - "custom://resource", - "Custom Resource", - "Description", - "application/json", - null - ), - (request) -> new ReadResourceResult( - List.of(new TextResourceContents( - request.uri(), - "application/json", - "{\"data\": \"example\"}" - )) - ) - ); - - // Create custom prompt - var customPrompt = new PromptRegistration( - new McpSchema.Prompt( - "custom-prompt", - "Description", - List.of(new McpSchema.PromptArgument("input", "Description", true)) - ), - request -> { - String input = (String) request.arguments().get("input"); - var message = new PromptMessage( - Role.ASSISTANT, - new TextContent("Response to: " + input) - ); - return new GetPromptResult("Result", List.of(message)); - } - ); - - // Create and configure the server - return McpServer.using(transport) - .info("Custom MCP Server", "1.0.0") - .capabilities(capabilities) - .tools(List.of(customTool)) - .resources(Map.of("custom://resource", customResource)) - .prompts(List.of(customPrompt)) - .async(); - } -} -``` - -## Configuration - -The application can be configured through `application.properties`: - -- `transport.mode`: Transport mode to use (stdio/sse) -- `server.port`: Server port for SSE mode (default: 8080) -- Various logging configurations are available for debugging - -## Implementation Details - -The sample demonstrates: -- Creating an MCP server with custom tools, resources, and prompts -- Configuring different transport modes -- Implementing tool handlers with JSON schema validation -- Resource implementations with dynamic content generation -- Prompt implementations with parameter handling -- Error handling and response formatting -- Synchronous client usage patterns diff --git a/model-context-protocol/book-library/manual-webflux-server/mvnw b/model-context-protocol/book-library/manual-webflux-server/mvnw deleted file mode 100755 index 19529dd..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/mvnw +++ /dev/null @@ -1,259 +0,0 @@ -#!/bin/sh -# ---------------------------------------------------------------------------- -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# ---------------------------------------------------------------------------- - -# ---------------------------------------------------------------------------- -# Apache Maven Wrapper startup batch script, version 3.3.2 -# -# Optional ENV vars -# ----------------- -# JAVA_HOME - location of a JDK home dir, required when download maven via java source -# MVNW_REPOURL - repo url base for downloading maven distribution -# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output -# ---------------------------------------------------------------------------- - -set -euf -[ "${MVNW_VERBOSE-}" != debug ] || set -x - -# OS specific support. -native_path() { printf %s\\n "$1"; } -case "$(uname)" in -CYGWIN* | MINGW*) - [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" - native_path() { cygpath --path --windows "$1"; } - ;; -esac - -# set JAVACMD and JAVACCMD -set_java_home() { - # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched - if [ -n "${JAVA_HOME-}" ]; then - if [ -x "$JAVA_HOME/jre/sh/java" ]; then - # IBM's JDK on AIX uses strange locations for the executables - JAVACMD="$JAVA_HOME/jre/sh/java" - JAVACCMD="$JAVA_HOME/jre/sh/javac" - else - JAVACMD="$JAVA_HOME/bin/java" - JAVACCMD="$JAVA_HOME/bin/javac" - - if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then - echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 - echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 - return 1 - fi - fi - else - JAVACMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v java - )" || : - JAVACCMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v javac - )" || : - - if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then - echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 - return 1 - fi - fi -} - -# hash string like Java String::hashCode -hash_string() { - str="${1:-}" h=0 - while [ -n "$str" ]; do - char="${str%"${str#?}"}" - h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) - str="${str#?}" - done - printf %x\\n $h -} - -verbose() { :; } -[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } - -die() { - printf %s\\n "$1" >&2 - exit 1 -} - -trim() { - # MWRAPPER-139: - # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. - # Needed for removing poorly interpreted newline sequences when running in more - # exotic environments such as mingw bash on Windows. - printf "%s" "${1}" | tr -d '[:space:]' -} - -# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties -while IFS="=" read -r key value; do - case "${key-}" in - distributionUrl) distributionUrl=$(trim "${value-}") ;; - distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; - esac -done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties" -[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties" - -case "${distributionUrl##*/}" in -maven-mvnd-*bin.*) - MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ - case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in - *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; - :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; - :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; - :Linux*x86_64*) distributionPlatform=linux-amd64 ;; - *) - echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 - distributionPlatform=linux-amd64 - ;; - esac - distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" - ;; -maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; -*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; -esac - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" -distributionUrlName="${distributionUrl##*/}" -distributionUrlNameMain="${distributionUrlName%.*}" -distributionUrlNameMain="${distributionUrlNameMain%-bin}" -MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" -MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" - -exec_maven() { - unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : - exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" -} - -if [ -d "$MAVEN_HOME" ]; then - verbose "found existing MAVEN_HOME at $MAVEN_HOME" - exec_maven "$@" -fi - -case "${distributionUrl-}" in -*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; -*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; -esac - -# prepare tmp dir -if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then - clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } - trap clean HUP INT TERM EXIT -else - die "cannot create temp dir" -fi - -mkdir -p -- "${MAVEN_HOME%/*}" - -# Download and Install Apache Maven -verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -verbose "Downloading from: $distributionUrl" -verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -# select .zip or .tar.gz -if ! command -v unzip >/dev/null; then - distributionUrl="${distributionUrl%.zip}.tar.gz" - distributionUrlName="${distributionUrl##*/}" -fi - -# verbose opt -__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' -[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v - -# normalize http auth -case "${MVNW_PASSWORD:+has-password}" in -'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; -has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; -esac - -if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then - verbose "Found wget ... using wget" - wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" -elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then - verbose "Found curl ... using curl" - curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" -elif set_java_home; then - verbose "Falling back to use Java to download" - javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" - targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" - cat >"$javaSource" <<-END - public class Downloader extends java.net.Authenticator - { - protected java.net.PasswordAuthentication getPasswordAuthentication() - { - return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); - } - public static void main( String[] args ) throws Exception - { - setDefault( new Downloader() ); - java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); - } - } - END - # For Cygwin/MinGW, switch paths to Windows format before running javac and java - verbose " - Compiling Downloader.java ..." - "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" - verbose " - Running Downloader.java ..." - "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" -fi - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -if [ -n "${distributionSha256Sum-}" ]; then - distributionSha256Result=false - if [ "$MVN_CMD" = mvnd.sh ]; then - echo "Checksum validation is not supported for maven-mvnd." >&2 - echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - elif command -v sha256sum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - elif command -v shasum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - else - echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2 - echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - fi - if [ $distributionSha256Result = false ]; then - echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 - echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 - exit 1 - fi -fi - -# unzip and move -if command -v unzip >/dev/null; then - unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" -else - tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" -fi -printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url" -mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" - -clean || : -exec_maven "$@" diff --git a/model-context-protocol/book-library/manual-webflux-server/mvnw.cmd b/model-context-protocol/book-library/manual-webflux-server/mvnw.cmd deleted file mode 100644 index b150b91..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/mvnw.cmd +++ /dev/null @@ -1,149 +0,0 @@ -<# : batch portion -@REM ---------------------------------------------------------------------------- -@REM Licensed to the Apache Software Foundation (ASF) under one -@REM or more contributor license agreements. See the NOTICE file -@REM distributed with this work for additional information -@REM regarding copyright ownership. The ASF licenses this file -@REM to you under the Apache License, Version 2.0 (the -@REM "License"); you may not use this file except in compliance -@REM with the License. You may obtain a copy of the License at -@REM -@REM http://www.apache.org/licenses/LICENSE-2.0 -@REM -@REM Unless required by applicable law or agreed to in writing, -@REM software distributed under the License is distributed on an -@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -@REM KIND, either express or implied. See the License for the -@REM specific language governing permissions and limitations -@REM under the License. -@REM ---------------------------------------------------------------------------- - -@REM ---------------------------------------------------------------------------- -@REM Apache Maven Wrapper startup batch script, version 3.3.2 -@REM -@REM Optional ENV vars -@REM MVNW_REPOURL - repo url base for downloading maven distribution -@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output -@REM ---------------------------------------------------------------------------- - -@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) -@SET __MVNW_CMD__= -@SET __MVNW_ERROR__= -@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% -@SET PSModulePath= -@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( - IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) -) -@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% -@SET __MVNW_PSMODULEP_SAVE= -@SET __MVNW_ARG0_NAME__= -@SET MVNW_USERNAME= -@SET MVNW_PASSWORD= -@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*) -@echo Cannot start maven from wrapper >&2 && exit /b 1 -@GOTO :EOF -: end batch / begin powershell #> - -$ErrorActionPreference = "Stop" -if ($env:MVNW_VERBOSE -eq "true") { - $VerbosePreference = "Continue" -} - -# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties -$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl -if (!$distributionUrl) { - Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" -} - -switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { - "maven-mvnd-*" { - $USE_MVND = $true - $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" - $MVN_CMD = "mvnd.cmd" - break - } - default { - $USE_MVND = $false - $MVN_CMD = $script -replace '^mvnw','mvn' - break - } -} - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -if ($env:MVNW_REPOURL) { - $MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" } - $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')" -} -$distributionUrlName = $distributionUrl -replace '^.*/','' -$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' -$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain" -if ($env:MAVEN_USER_HOME) { - $MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain" -} -$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' -$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" - -if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { - Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" - Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" - exit $? -} - -if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { - Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" -} - -# prepare tmp dir -$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile -$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" -$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null -trap { - if ($TMP_DOWNLOAD_DIR.Exists) { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } - } -} - -New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null - -# Download and Install Apache Maven -Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -Write-Verbose "Downloading from: $distributionUrl" -Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -$webclient = New-Object System.Net.WebClient -if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { - $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) -} -[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 -$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum -if ($distributionSha256Sum) { - if ($USE_MVND) { - Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." - } - Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash - if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { - Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." - } -} - -# unzip and move -Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null -Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null -try { - Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null -} catch { - if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { - Write-Error "fail to move MAVEN_HOME" - } -} finally { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } -} - -Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/model-context-protocol/book-library/manual-webflux-server/pom.xml b/model-context-protocol/book-library/manual-webflux-server/pom.xml deleted file mode 100644 index 9e5ab7f..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/pom.xml +++ /dev/null @@ -1,109 +0,0 @@ - - - 4.0.0 - - org.springframework.boot - spring-boot-starter-parent - 3.3.6 - - - - com.example - - mcp-webflux-server - 0.0.1-SNAPSHOT - - Spring AI MCP StdIO and WebFluxSSE Sample - Sample Spring Boot application demonstrating MCP server usage - - - 0.6.0 - - - - - - org.springframework.experimental - mcp-bom - ${spring-ai-mcp.version} - pom - import - - - - - - - org.springframework.experimental - mcp-webflux-sse-transport - - - - org.springframework.experimental - spring-ai-mcp - - - - org.springframework.boot - spring-boot-starter-webflux - - - - org.springframework.boot - spring-boot-starter-test - test - - - - - - - org.springframework.boot - spring-boot-maven-plugin - - - - repackage - - - - - - io.spring.javaformat - spring-javaformat-maven-plugin - 0.0.43 - - - validate - true - - validate - - - - - - - - - - spring-milestones - Spring Milestones - https://repo.spring.io/milestone - - false - - - - spring-snapshots - Spring Snapshots - https://repo.spring.io/snapshot - - false - - - - - \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java deleted file mode 100644 index 586f8d8..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java +++ /dev/null @@ -1,13 +0,0 @@ -package org.springframework.ai.mcp.sample.server; - -import org.springframework.boot.SpringApplication; -import org.springframework.boot.autoconfigure.SpringBootApplication; - -@SpringBootApplication -public class McpServerApplication { - - public static void main(String[] args) { - SpringApplication.run(McpServerApplication.class, args); - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java b/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java deleted file mode 100644 index 05e4bfd..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java +++ /dev/null @@ -1,163 +0,0 @@ -package org.springframework.ai.mcp.sample.server; - -import java.util.List; -import java.util.Map; -import java.util.function.Function; - -import com.fasterxml.jackson.databind.ObjectMapper; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import org.springframework.ai.mcp.server.McpServer; -import org.springframework.ai.mcp.server.McpServerFeatures; -import org.springframework.ai.mcp.server.McpSyncServer; -import org.springframework.ai.mcp.server.transport.StdioServerTransport; -import org.springframework.ai.mcp.server.transport.WebFluxSseServerTransport; -import org.springframework.ai.mcp.spec.McpSchema; -import org.springframework.ai.mcp.spec.McpSchema.GetPromptResult; -import org.springframework.ai.mcp.spec.McpSchema.PromptMessage; -import org.springframework.ai.mcp.spec.McpSchema.Role; -import org.springframework.ai.mcp.spec.McpSchema.TextContent; -import org.springframework.ai.mcp.spec.ServerMcpTransport; -import org.springframework.ai.mcp.spring.ToolHelper; -import org.springframework.ai.model.function.FunctionCallback; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; -import org.springframework.web.client.RestClient; -import org.springframework.web.reactive.function.server.RouterFunction; - -@Configuration -public class McpServerConfig { - - private static final Logger logger = LoggerFactory.getLogger(McpServerConfig.class); - - // STDIO transport - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "stdio") - public StdioServerTransport stdioServerTransport() { - return new StdioServerTransport(); - } - - // SSE transport - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public WebFluxSseServerTransport sseServerTransport() { - return new WebFluxSseServerTransport(new ObjectMapper(), "/mcp/message"); - } - - // Router function for SSE transport used by Spring WebFlux to start an HTTP - // server. - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public RouterFunction mcpRouterFunction(WebFluxSseServerTransport transport) { - return transport.getRouterFunction(); - } - - public static record ToUpperCaseInput(String input) { - } - - @Bean - public McpSyncServer mcpServer(ServerMcpTransport transport, OpenLibrary openLibrary) { // @formatter:off - - // Configure server capabilities with resource support - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // No subscribe support, but list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .logging() // Logging support - .build(); - - // Create the server with both tool and resource capabilities - McpSyncServer server = McpServer.sync(transport) - .serverInfo("MCP Demo WebFlux Server", "1.0.0") - .capabilities(capabilities) - .resources(systemInfoResourceRegistration()) // Resources - .prompts(greetingPromptRegistration()) // Prompts - .tools(openLibraryToolRegistrations(openLibrary)) // Method based tools - .tools(ToolHelper.toSyncToolRegistration( // java.util.Function based tools - FunctionCallback.builder() - .function("toUpperCase", (Function) s -> s.input().toUpperCase()) - .description("To upper case") - .inputType(ToUpperCaseInput.class) - .build())) - .build(); - - return server; // @formatter:on - } // @formatter:on - - public static List openLibraryToolRegistrations(OpenLibrary openLibrary) { - - var books = FunctionCallback.builder() - .method("getBooks", String.class) - .description("Get list of Books by title") - .targetObject(openLibrary) - .build(); - - var bookTitlesByAuthor = FunctionCallback.builder() - .method("getBookTitlesByAuthor", String.class) - .description("Get book titles by author") - .targetObject(openLibrary) - .build(); - - return ToolHelper.toSyncToolRegistration(books, bookTitlesByAuthor); - } - - private static McpServerFeatures.SyncResourceRegistration systemInfoResourceRegistration() { - - // Create a resource registration for system information - var systemInfoResource = new McpSchema.Resource( // @formatter:off - "system://info", - "System Information", - "Provides basic system information including Java version, OS, etc.", - "application/json", null - ); - - var resourceRegistration = new McpServerFeatures.SyncResourceRegistration(systemInfoResource, (request) -> { - try { - var systemInfo = Map.of( - "javaVersion", System.getProperty("java.version"), - "osName", System.getProperty("os.name"), - "osVersion", System.getProperty("os.version"), - "osArch", System.getProperty("os.arch"), - "processors", Runtime.getRuntime().availableProcessors(), - "timestamp", System.currentTimeMillis()); - - String jsonContent = new ObjectMapper().writeValueAsString(systemInfo); - - return new McpSchema.ReadResourceResult( - List.of(new McpSchema.TextResourceContents(request.uri(), "application/json", jsonContent))); - } - catch (Exception e) { - throw new RuntimeException("Failed to generate system info", e); - } - }); // @formatter:on - - return resourceRegistration; - } - - private static McpServerFeatures.SyncPromptRegistration greetingPromptRegistration() { - - var prompt = new McpSchema.Prompt("greeting", "A friendly greeting prompt", - List.of(new McpSchema.PromptArgument("name", "The name to greet", true))); - - return new McpServerFeatures.SyncPromptRegistration(prompt, getPromptRequest -> { - - String nameArgument = (String) getPromptRequest.arguments().get("name"); - if (nameArgument == null) { - nameArgument = "friend"; - } - - var userMessage = new PromptMessage(Role.USER, - new TextContent("Hello " + nameArgument + "! How can I assist you today?")); - - return new GetPromptResult("A personalized greeting message", List.of(userMessage)); - }); - } - - @Bean - public OpenLibrary openLibrary() { - return new OpenLibrary(RestClient.builder()); - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java b/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java deleted file mode 100644 index 7f96573..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java +++ /dev/null @@ -1,74 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.server; - -import java.util.List; -import java.util.Map; - -import org.springframework.web.client.RestClient; - -/** - * @author Christian Tzolov - */ - -public class OpenLibrary { - - private RestClient restClient; - - public OpenLibrary(RestClient.Builder restClientBuilder) { - this.restClient = restClientBuilder.baseUrl("https://openlibrary.org").build(); - } - - public record Books(Integer numFound, Integer start, Boolean numFoundExact, List> docs) { - } - - public record Book(List isbn, String title, List authorName) { - } - - public List getBooks(String title) { - Books books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search.json").queryParam("q", title).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream() - .map(doc -> new Book((List) doc.get("isbn"), (String) doc.get("title"), - (List) doc.get("author_name"))) - .toList(); - } - - public List getBookTitlesByAuthor(String authorName) { - var books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search/authors.json").queryParam("q", authorName).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream().map(doc -> (String) doc.get("top_work")).toList(); - } - - public static void main(String[] args) { - OpenLibrary openLibrary = new OpenLibrary(RestClient.builder()); - List books = openLibrary.getBooks("Spring Framework"); - System.out.println(books); - List booksByAuthor = openLibrary.getBookTitlesByAuthor("Craig Walls"); - System.out.println(booksByAuthor); - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/src/main/resources/application.properties b/model-context-protocol/book-library/manual-webflux-server/src/main/resources/application.properties deleted file mode 100644 index b2b3fcc..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/main/resources/application.properties +++ /dev/null @@ -1,11 +0,0 @@ -# spring.main.web-application-type=none - -# NOTE: You must disable the banner and the console logging -# to allow the STDIO transport to work !!! -spring.main.banner-mode=off -logging.pattern.console= - -# transport.mode=stdio -transport.mode=sse - -logging.file.name=mcp.webflux.log \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java deleted file mode 100644 index 9476dfd..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java +++ /dev/null @@ -1,43 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import java.io.File; - -import org.springframework.ai.mcp.client.transport.ServerParameters; -import org.springframework.ai.mcp.client.transport.StdioClientTransport; - -/** - * With stdio transport, the MCP server is automatically started by the client. But you - * have to build the server jar first: 
./mvnw clean install -DskipTests
- */ -public class ClientStdio { - - public static void main(String[] args) { - - System.out.println(new File(".").getAbsolutePath()); - - var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-Dspring.main.web-application-type=none", "-jar", - "model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar") - .build(); - - var transport = new StdioClientTransport(stdioParams); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java b/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java deleted file mode 100644 index de0b211..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java +++ /dev/null @@ -1,32 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import org.springframework.ai.mcp.client.transport.WebFluxSseClientTransport; -import org.springframework.web.reactive.function.client.WebClient; - -/** - * @author Christian Tzolov - */ -public class ClientWebFluxSse { - - public static void main(String[] args) { - var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java b/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java deleted file mode 100644 index a2b0eba..0000000 --- a/model-context-protocol/book-library/manual-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java +++ /dev/null @@ -1,80 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import java.util.Map; - -import org.springframework.ai.mcp.client.McpClient; -import org.springframework.ai.mcp.spec.ClientMcpTransport; -import org.springframework.ai.mcp.spec.McpSchema.CallToolRequest; -import org.springframework.ai.mcp.spec.McpSchema.CallToolResult; -import org.springframework.ai.mcp.spec.McpSchema.GetPromptRequest; -import org.springframework.ai.mcp.spec.McpSchema.ListPromptsResult; -import org.springframework.ai.mcp.spec.McpSchema.ListToolsResult; -import org.springframework.ai.mcp.spec.McpSchema.ReadResourceRequest; - -/** - * @author Christian Tzolov - */ - -public class SampleClient { - - private final ClientMcpTransport transport; - - public SampleClient(ClientMcpTransport transport) { - this.transport = transport; - } - - public void run() { - - var client = McpClient.sync(this.transport).build(); - - client.initialize(); - - client.ping(); - - // List and demonstrate tools - ListToolsResult toolsList = client.listTools(); - System.out.println("Available Tools = " + toolsList); - - CallToolResult upperCaseResult = client - .callTool(new CallToolRequest("toUpperCase", Map.of("input", "accountName"))); - System.out.println("Upper case Response = " + upperCaseResult); - - CallToolResult books = client.callTool(new CallToolRequest("getBooks", Map.of("title", "Spring Framework"))); - System.out.println("Books Response = " + books); - - // List and demonstrate resources - var resourcesList = client.listResources(); - System.out.println("\nAvailable Resources = " + resourcesList); - - // Read the system info resource - var systemInfo = client.readResource(new ReadResourceRequest("system://info")); - System.out.println("System Info = " + systemInfo); - - // List and demonstrate prompts - ListPromptsResult promptsList = client.listPrompts(); - System.out.println("\nAvailable Prompts = " + promptsList); - - // Try the greeting prompt - var greetingResponse = client.getPrompt(new GetPromptRequest("greeting", Map.of("name", "Spring"))); - System.out.println("Greeting Response = " + greetingResponse); - - client.closeGracefully(); - - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/.flattened-pom.xml b/model-context-protocol/book-library/manual-webmvc-server/.flattened-pom.xml deleted file mode 100644 index b7ac98a..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/.flattened-pom.xml +++ /dev/null @@ -1,49 +0,0 @@ - - - 4.0.0 - org.springframework.experimental - spring-ai-mcp-webmvc-sample - 0.5.0-SNAPSHOT - Spring AI MCP Sample - Sample Spring Boot application demonstrating MCP server usage - - Spring Framework - https://spring.io - - - - Apache 2.0 - https://www.apache.org/licenses/LICENSE-2.0.txt - repo - - - - - Christian Tzolov - - - Dariusz Jędrzejczyk - - - - - org.springframework.experimental - mcp-webmvc-sse-transport - 0.5.0-SNAPSHOT - compile - - - org.springframework.experimental - spring-ai-mcp - 0.5.0-SNAPSHOT - compile - - - org.springframework.boot - spring-boot-starter-web - 3.4.1 - compile - - - diff --git a/model-context-protocol/book-library/manual-webmvc-server/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/book-library/manual-webmvc-server/.mvn/wrapper/maven-wrapper.properties deleted file mode 100644 index d58dfb7..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/.mvn/wrapper/maven-wrapper.properties +++ /dev/null @@ -1,19 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -wrapperVersion=3.3.2 -distributionType=only-script -distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip diff --git a/model-context-protocol/book-library/manual-webmvc-server/README.md b/model-context-protocol/book-library/manual-webmvc-server/README.md deleted file mode 100644 index 7b82ab2..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/README.md +++ /dev/null @@ -1,257 +0,0 @@ -# Spring AI MCP WebMVC Server Sample Project - -This sample project demonstrates the usage of the Spring AI Model Context Protocol (MCP) implementation. It showcases how to create and use MCP WebMvc servers and Http Sse clients with different capabilities. - -## Overview - -The sample provides: -- Two transport mode implementations: Stdio and SSE (Server-Sent Events) -- Server capabilities: - - Tools support with list changes notifications - - Resources support with list changes notifications (no subscribe support) - - Prompts support with list changes notifications -- Sample implementations: - - Two MCP tools: Weather and Calculator - - One MCP resource: System Information - - One MCP prompt: Greeting - -## Building the Project - -```bash -./mvnw clean package -``` - -## Running the Server - -The server can be started in two transport modes, controlled by the `transport.mode` property: - -### Stdio Mode (Default) - -```bash -java -Dtransport.mode=stdio -jar target/mcp-webmvc-server-0.0.1-SNAPSHOT.jar -``` - -The Stdio mode server is automatically started by the client - no explicit server startup is needed. -But you have to build the server jar first: `./mvnw clean install -DskipTests`. - -In Stdio mode the server must not emit any messages/logs to the console (e.g. standard out) but the JSON messages produced by the server. - -### SSE Mode -```bash -java -Dtransport.mode=sse -jar target/smcp-webmvc-server-0.0.1-SNAPSHOT.jar -``` - -## Sample Clients - -The project includes example clients for both transport modes: - -### Stdio Client (ClientStdio.java) -```java -var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-jar", - "target/mcp-webmvc-server-0.0.1-SNAPSHOT.jar") - .build(); - -var transport = new StdioClientTransport(stdioParams); -var client = McpClient.using(transport).sync(); -``` - -### SSE Client (ClientSse.java) -```java -var transport = new HttpClientSseClientTransport("http://localhost:8080"); -var client = McpClient.using(transport).sync(); -``` - -## Available Tools - -### Weather Tool -- Name: `weather` -- Description: Weather forecast tool by location -- Parameters: - - `city`: String - The city to get weather for -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -``` - -### Calculator Tool -- Name: `calculator` -- Description: Performs basic arithmetic operations -- Parameters (JSON Schema): - ```json - { - "operation": { - "type": "string", - "enum": ["add", "subtract", "multiply", "divide"], - "description": "The arithmetic operation to perform" - }, - "a": { - "type": "number", - "description": "First operand" - }, - "b": { - "type": "number", - "description": "Second operand" - } - } - ``` -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("calculator", - Map.of("operation", "multiply", "a", 2.0, "b", 3.0)) -); -``` - -## Available Resources - -### System Information Resource -- URI: `system://info` -- Description: Provides basic system information including Java version, OS, etc. -- MIME Type: application/json -- Returns: JSON object containing: javaVersion, osName, osVersion, osArch, processors, timestamp - -## Available Prompts - -### Greeting Prompt -- Name: `greeting` -- Description: A friendly greeting prompt -- Parameters: - - `name`: String (required) - The name to greet -- Returns: A personalized greeting message from an assistant - -## Client Usage Example - -```java -// Initialize client -client.initialize(); - -// Test connection -client.ping(); - -// List available tools -ListToolsResult tools = client.listTools(); -System.out.println("Available tools: " + tools); - -// Call weather tool -CallToolResult weather = client.callTool( - new CallToolRequest("weather", Map.of("city", "Sofia")) -); -System.out.println("Weather: " + weather); - -// Call calculator tool -CallToolResult calc = client.callTool( - new CallToolRequest("calculator", - Map.of("operation", "multiply", "a", 2.0, "b", 3.0)) -); -System.out.println("Calculation: " + calc); - -// Access system info resource -ReadResourceResult sysInfo = client.readResource( - new ReadResourceRequest("system://info") -); -System.out.println("System Info: " + sysInfo); - -// Use greeting prompt -GetPromptResult greeting = client.getPrompt( - new GetPromptRequest("greeting", Map.of("name", "John")) -); -System.out.println("Greeting: " + greeting); - -// Close client -client.closeGracefully(); -``` - -## Server Usage Example - -```java -@Configuration -public class CustomMcpServerConfig { - @Bean - public McpAsyncServer mcpServer(McpTransport transport) { - // Configure server capabilities - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // Resource support with list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .build(); - - // Create custom tool - var customTool = new ToolRegistration( - new McpSchema.Tool("custom-tool", "Description", Map.of("param", "String")), - (arguments) -> { - String param = (String) arguments.get("param"); - return new CallToolResult( - List.of(new TextContent("Result: " + param)), - false - ); - } - ); - - // Create custom resource - var customResource = new ResourceRegistration( - new McpSchema.Resource( - "custom://resource", - "Custom Resource", - "Description", - "application/json", - null - ), - (request) -> new ReadResourceResult( - List.of(new TextResourceContents( - request.uri(), - "application/json", - "{\"data\": \"example\"}" - )) - ) - ); - - // Create custom prompt - var customPrompt = new PromptRegistration( - new McpSchema.Prompt( - "custom-prompt", - "Description", - List.of(new McpSchema.PromptArgument("input", "Description", true)) - ), - request -> { - String input = (String) request.arguments().get("input"); - var message = new PromptMessage( - Role.ASSISTANT, - new TextContent("Response to: " + input) - ); - return new GetPromptResult("Result", List.of(message)); - } - ); - - // Create and configure the server - return McpServer.using(transport) - .info("Custom MCP Server", "1.0.0") - .capabilities(capabilities) - .tools(List.of(customTool)) - .resources(Map.of("custom://resource", customResource)) - .prompts(List.of(customPrompt)) - .async(); - } -} -``` - -## Configuration - -The application can be configured through `application.properties`: - -- `transport.mode`: Transport mode to use (stdio/sse) -- `server.port`: Server port for SSE mode (default: 8080) -- Various logging configurations are available for debugging - -## Implementation Details - -The sample demonstrates: -- Creating an MCP server with custom tools, resources, and prompts -- Configuring different transport modes -- Implementing tool handlers with JSON schema validation -- Resource implementations with dynamic content generation -- Prompt implementations with parameter handling -- Error handling and response formatting -- Synchronous client usage patterns diff --git a/model-context-protocol/book-library/manual-webmvc-server/mvnw b/model-context-protocol/book-library/manual-webmvc-server/mvnw deleted file mode 100755 index 19529dd..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/mvnw +++ /dev/null @@ -1,259 +0,0 @@ -#!/bin/sh -# ---------------------------------------------------------------------------- -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# ---------------------------------------------------------------------------- - -# ---------------------------------------------------------------------------- -# Apache Maven Wrapper startup batch script, version 3.3.2 -# -# Optional ENV vars -# ----------------- -# JAVA_HOME - location of a JDK home dir, required when download maven via java source -# MVNW_REPOURL - repo url base for downloading maven distribution -# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output -# ---------------------------------------------------------------------------- - -set -euf -[ "${MVNW_VERBOSE-}" != debug ] || set -x - -# OS specific support. -native_path() { printf %s\\n "$1"; } -case "$(uname)" in -CYGWIN* | MINGW*) - [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" - native_path() { cygpath --path --windows "$1"; } - ;; -esac - -# set JAVACMD and JAVACCMD -set_java_home() { - # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched - if [ -n "${JAVA_HOME-}" ]; then - if [ -x "$JAVA_HOME/jre/sh/java" ]; then - # IBM's JDK on AIX uses strange locations for the executables - JAVACMD="$JAVA_HOME/jre/sh/java" - JAVACCMD="$JAVA_HOME/jre/sh/javac" - else - JAVACMD="$JAVA_HOME/bin/java" - JAVACCMD="$JAVA_HOME/bin/javac" - - if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then - echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 - echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 - return 1 - fi - fi - else - JAVACMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v java - )" || : - JAVACCMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v javac - )" || : - - if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then - echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 - return 1 - fi - fi -} - -# hash string like Java String::hashCode -hash_string() { - str="${1:-}" h=0 - while [ -n "$str" ]; do - char="${str%"${str#?}"}" - h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) - str="${str#?}" - done - printf %x\\n $h -} - -verbose() { :; } -[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } - -die() { - printf %s\\n "$1" >&2 - exit 1 -} - -trim() { - # MWRAPPER-139: - # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. - # Needed for removing poorly interpreted newline sequences when running in more - # exotic environments such as mingw bash on Windows. - printf "%s" "${1}" | tr -d '[:space:]' -} - -# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties -while IFS="=" read -r key value; do - case "${key-}" in - distributionUrl) distributionUrl=$(trim "${value-}") ;; - distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; - esac -done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties" -[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties" - -case "${distributionUrl##*/}" in -maven-mvnd-*bin.*) - MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ - case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in - *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; - :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; - :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; - :Linux*x86_64*) distributionPlatform=linux-amd64 ;; - *) - echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 - distributionPlatform=linux-amd64 - ;; - esac - distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" - ;; -maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; -*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; -esac - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" -distributionUrlName="${distributionUrl##*/}" -distributionUrlNameMain="${distributionUrlName%.*}" -distributionUrlNameMain="${distributionUrlNameMain%-bin}" -MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" -MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" - -exec_maven() { - unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : - exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" -} - -if [ -d "$MAVEN_HOME" ]; then - verbose "found existing MAVEN_HOME at $MAVEN_HOME" - exec_maven "$@" -fi - -case "${distributionUrl-}" in -*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; -*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; -esac - -# prepare tmp dir -if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then - clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } - trap clean HUP INT TERM EXIT -else - die "cannot create temp dir" -fi - -mkdir -p -- "${MAVEN_HOME%/*}" - -# Download and Install Apache Maven -verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -verbose "Downloading from: $distributionUrl" -verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -# select .zip or .tar.gz -if ! command -v unzip >/dev/null; then - distributionUrl="${distributionUrl%.zip}.tar.gz" - distributionUrlName="${distributionUrl##*/}" -fi - -# verbose opt -__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' -[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v - -# normalize http auth -case "${MVNW_PASSWORD:+has-password}" in -'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; -has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; -esac - -if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then - verbose "Found wget ... using wget" - wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" -elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then - verbose "Found curl ... using curl" - curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" -elif set_java_home; then - verbose "Falling back to use Java to download" - javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" - targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" - cat >"$javaSource" <<-END - public class Downloader extends java.net.Authenticator - { - protected java.net.PasswordAuthentication getPasswordAuthentication() - { - return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); - } - public static void main( String[] args ) throws Exception - { - setDefault( new Downloader() ); - java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); - } - } - END - # For Cygwin/MinGW, switch paths to Windows format before running javac and java - verbose " - Compiling Downloader.java ..." - "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" - verbose " - Running Downloader.java ..." - "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" -fi - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -if [ -n "${distributionSha256Sum-}" ]; then - distributionSha256Result=false - if [ "$MVN_CMD" = mvnd.sh ]; then - echo "Checksum validation is not supported for maven-mvnd." >&2 - echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - elif command -v sha256sum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - elif command -v shasum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - else - echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2 - echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - fi - if [ $distributionSha256Result = false ]; then - echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 - echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 - exit 1 - fi -fi - -# unzip and move -if command -v unzip >/dev/null; then - unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" -else - tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" -fi -printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url" -mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" - -clean || : -exec_maven "$@" diff --git a/model-context-protocol/book-library/manual-webmvc-server/mvnw.cmd b/model-context-protocol/book-library/manual-webmvc-server/mvnw.cmd deleted file mode 100644 index b150b91..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/mvnw.cmd +++ /dev/null @@ -1,149 +0,0 @@ -<# : batch portion -@REM ---------------------------------------------------------------------------- -@REM Licensed to the Apache Software Foundation (ASF) under one -@REM or more contributor license agreements. See the NOTICE file -@REM distributed with this work for additional information -@REM regarding copyright ownership. The ASF licenses this file -@REM to you under the Apache License, Version 2.0 (the -@REM "License"); you may not use this file except in compliance -@REM with the License. You may obtain a copy of the License at -@REM -@REM http://www.apache.org/licenses/LICENSE-2.0 -@REM -@REM Unless required by applicable law or agreed to in writing, -@REM software distributed under the License is distributed on an -@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -@REM KIND, either express or implied. See the License for the -@REM specific language governing permissions and limitations -@REM under the License. -@REM ---------------------------------------------------------------------------- - -@REM ---------------------------------------------------------------------------- -@REM Apache Maven Wrapper startup batch script, version 3.3.2 -@REM -@REM Optional ENV vars -@REM MVNW_REPOURL - repo url base for downloading maven distribution -@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output -@REM ---------------------------------------------------------------------------- - -@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) -@SET __MVNW_CMD__= -@SET __MVNW_ERROR__= -@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% -@SET PSModulePath= -@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( - IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) -) -@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% -@SET __MVNW_PSMODULEP_SAVE= -@SET __MVNW_ARG0_NAME__= -@SET MVNW_USERNAME= -@SET MVNW_PASSWORD= -@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*) -@echo Cannot start maven from wrapper >&2 && exit /b 1 -@GOTO :EOF -: end batch / begin powershell #> - -$ErrorActionPreference = "Stop" -if ($env:MVNW_VERBOSE -eq "true") { - $VerbosePreference = "Continue" -} - -# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties -$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl -if (!$distributionUrl) { - Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" -} - -switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { - "maven-mvnd-*" { - $USE_MVND = $true - $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" - $MVN_CMD = "mvnd.cmd" - break - } - default { - $USE_MVND = $false - $MVN_CMD = $script -replace '^mvnw','mvn' - break - } -} - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -if ($env:MVNW_REPOURL) { - $MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" } - $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')" -} -$distributionUrlName = $distributionUrl -replace '^.*/','' -$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' -$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain" -if ($env:MAVEN_USER_HOME) { - $MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain" -} -$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' -$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" - -if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { - Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" - Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" - exit $? -} - -if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { - Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" -} - -# prepare tmp dir -$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile -$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" -$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null -trap { - if ($TMP_DOWNLOAD_DIR.Exists) { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } - } -} - -New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null - -# Download and Install Apache Maven -Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -Write-Verbose "Downloading from: $distributionUrl" -Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -$webclient = New-Object System.Net.WebClient -if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { - $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) -} -[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 -$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum -if ($distributionSha256Sum) { - if ($USE_MVND) { - Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." - } - Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash - if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { - Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." - } -} - -# unzip and move -Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null -Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null -try { - Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null -} catch { - if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { - Write-Error "fail to move MAVEN_HOME" - } -} finally { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } -} - -Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/model-context-protocol/book-library/manual-webmvc-server/pom.xml b/model-context-protocol/book-library/manual-webmvc-server/pom.xml deleted file mode 100644 index 45c6cc2..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/pom.xml +++ /dev/null @@ -1,114 +0,0 @@ - - - 4.0.0 - - org.springframework.boot - spring-boot-starter-parent - 3.3.6 - - - - com.example - mcp-webmvc-server - 0.0.1-SNAPSHOT - - Spring AI MCP WebMvc Server Sample - Sample Spring Boot application demonstrating MCP WebMvc server usage - - - 0.6.0 - - - - - - org.springframework.experimental - mcp-bom - ${spring-ai-mcp.version} - pom - import - - - - - - - org.springframework.experimental - mcp-webmvc-sse-transport - - - - - org.springframework.experimental - mcp-webflux-sse-transport - - - - org.springframework.experimental - spring-ai-mcp - - - - org.springframework.boot - spring-boot-starter-web - - - - org.springframework.boot - spring-boot-starter-test - test - - - - - - - org.springframework.boot - spring-boot-maven-plugin - - - - repackage - - - - - - io.spring.javaformat - spring-javaformat-maven-plugin - 0.0.43 - - - validate - true - - validate - - - - - - - - - - spring-milestones - Spring Milestones - https://repo.spring.io/milestone - - false - - - - spring-snapshots - Spring Snapshots - https://repo.spring.io/snapshot - - false - - - - - \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpMvcServerApplication.java b/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpMvcServerApplication.java deleted file mode 100644 index cfff5e0..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpMvcServerApplication.java +++ /dev/null @@ -1,13 +0,0 @@ -package org.springframework.ai.mcp.sample.webmvc.server; - -import org.springframework.boot.SpringApplication; -import org.springframework.boot.autoconfigure.SpringBootApplication; - -@SpringBootApplication -public class McpMvcServerApplication { - - public static void main(String[] args) { - SpringApplication.run(McpMvcServerApplication.class, args); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpServerConfig.java b/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpServerConfig.java deleted file mode 100644 index 19e3282..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/McpServerConfig.java +++ /dev/null @@ -1,166 +0,0 @@ -package org.springframework.ai.mcp.sample.webmvc.server; - -import java.util.List; -import java.util.Map; -import java.util.function.Function; - -import com.fasterxml.jackson.databind.ObjectMapper; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import org.springframework.ai.mcp.server.McpServer; -import org.springframework.ai.mcp.server.McpServerFeatures.SyncPromptRegistration; -import org.springframework.ai.mcp.server.McpServerFeatures.SyncResourceRegistration; -import org.springframework.ai.mcp.server.McpServerFeatures.SyncToolRegistration; -import org.springframework.ai.mcp.server.McpSyncServer; -import org.springframework.ai.mcp.server.transport.StdioServerTransport; -import org.springframework.ai.mcp.server.transport.WebMvcSseServerTransport; -import org.springframework.ai.mcp.spec.McpSchema; -import org.springframework.ai.mcp.spec.McpSchema.GetPromptResult; -import org.springframework.ai.mcp.spec.McpSchema.PromptMessage; -import org.springframework.ai.mcp.spec.McpSchema.Role; -import org.springframework.ai.mcp.spec.McpSchema.TextContent; -import org.springframework.ai.mcp.spec.ServerMcpTransport; -import org.springframework.ai.mcp.spring.ToolHelper; -import org.springframework.ai.model.function.FunctionCallback; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; -import org.springframework.web.client.RestClient; -import org.springframework.web.servlet.config.annotation.EnableWebMvc; -import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; -import org.springframework.web.servlet.function.RouterFunction; -import org.springframework.web.servlet.function.ServerResponse; - -@Configuration -@EnableWebMvc -public class McpServerConfig implements WebMvcConfigurer { - - private static final Logger logger = LoggerFactory.getLogger(McpServerConfig.class); - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public WebMvcSseServerTransport webMvcSseServerTransport() { - return new WebMvcSseServerTransport(new ObjectMapper(), "/mcp/message"); - } - - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public RouterFunction routerFunction(WebMvcSseServerTransport transport) { - return transport.getRouterFunction(); - } - - // STDIO transport - @Bean - @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "stdio") - public StdioServerTransport stdioServerTransport() { - return new StdioServerTransport(); - } - - public static record ToUpperCaseInput(String input) { - } - - @Bean - public McpSyncServer mcpServer(ServerMcpTransport transport, OpenLibrary openLibrary) { // @formatter:off - - // Configure server capabilities with resource support - var capabilities = McpSchema.ServerCapabilities.builder() - .resources(false, true) // No subscribe support, but list changes notifications - .tools(true) // Tool support with list changes notifications - .prompts(true) // Prompt support with list changes notifications - .logging() // Logging support - .build(); - - // Create the server with both tool and resource capabilities - var server = McpServer.sync(transport) - .serverInfo("MCP Demo WebMVC Server", "1.0.0") - .capabilities(capabilities) - .resources(systemInfoResourceRegistration()) - .prompts(greetingPromptRegistration()) - .tools( - ToolHelper.toSyncToolRegistration( - FunctionCallback.builder() - .function("toUpperCase", (Function) s -> s.input().toUpperCase()) - .description("To upper case") - .inputType(ToUpperCaseInput.class) - .build())) - .tools(openLibraryToolRegistrations(openLibrary)) - .build(); - return server; // @formatter:on - } // @formatter:on - - public static List openLibraryToolRegistrations(OpenLibrary openLibrary) { - - var books = FunctionCallback.builder() - .method("getBooks", String.class) - .description("Get list of Books by title") - .targetObject(openLibrary) - .build(); - - var bookTitlesByAuthor = FunctionCallback.builder() - .method("getBookTitlesByAuthor", String.class) - .description("Get book titles by author") - .targetObject(openLibrary) - .build(); - - return ToolHelper.toSyncToolRegistration(books, bookTitlesByAuthor); - } - - private static SyncResourceRegistration systemInfoResourceRegistration() { - - // Create a resource registration for system information - var systemInfoResource = new McpSchema.Resource( // @formatter:off - "system://info", - "System Information", - "Provides basic system information including Java version, OS, etc.", - "application/json", null - ); - - var resourceRegistration = new SyncResourceRegistration(systemInfoResource, (request) -> { - try { - var systemInfo = Map.of( - "javaVersion", System.getProperty("java.version"), - "osName", System.getProperty("os.name"), - "osVersion", System.getProperty("os.version"), - "osArch", System.getProperty("os.arch"), - "processors", Runtime.getRuntime().availableProcessors(), - "timestamp", System.currentTimeMillis()); - - String jsonContent = new ObjectMapper().writeValueAsString(systemInfo); - - return new McpSchema.ReadResourceResult( - List.of(new McpSchema.TextResourceContents(request.uri(), "application/json", jsonContent))); - } - catch (Exception e) { - throw new RuntimeException("Failed to generate system info", e); - } - }); // @formatter:on - - return resourceRegistration; - } - - private static SyncPromptRegistration greetingPromptRegistration() { - - var prompt = new McpSchema.Prompt("greeting", "A friendly greeting prompt", - List.of(new McpSchema.PromptArgument("name", "The name to greet", true))); - - return new SyncPromptRegistration(prompt, getPromptRequest -> { - - String nameArgument = (String) getPromptRequest.arguments().get("name"); - if (nameArgument == null) { - nameArgument = "friend"; - } - - var userMessage = new PromptMessage(Role.USER, - new TextContent("Hello " + nameArgument + "! How can I assist you today?")); - - return new GetPromptResult("A personalized greeting message", List.of(userMessage)); - }); - } - - @Bean - public OpenLibrary openLibrary() { - return new OpenLibrary(RestClient.builder()); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/OpenLibrary.java b/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/OpenLibrary.java deleted file mode 100644 index 3dfe835..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/main/java/org/springframework/ai/mcp/sample/webmvc/server/OpenLibrary.java +++ /dev/null @@ -1,74 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.webmvc.server; - -import java.util.List; -import java.util.Map; - -import org.springframework.web.client.RestClient; - -/** - * @author Christian Tzolov - */ - -public class OpenLibrary { - - private RestClient restClient; - - public OpenLibrary(RestClient.Builder restClientBuilder) { - this.restClient = restClientBuilder.baseUrl("https://openlibrary.org").build(); - } - - public record Books(Integer numFound, Integer start, Boolean numFoundExact, List> docs) { - } - - public record Book(List isbn, String title, List authorName) { - } - - public List getBooks(String title) { - Books books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search.json").queryParam("q", title).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream() - .map(doc -> new Book((List) doc.get("isbn"), (String) doc.get("title"), - (List) doc.get("author_name"))) - .toList(); - } - - public List getBookTitlesByAuthor(String authorName) { - var books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search/authors.json").queryParam("q", authorName).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream().map(doc -> (String) doc.get("top_work")).toList(); - } - - public static void main(String[] args) { - OpenLibrary openLibrary = new OpenLibrary(RestClient.builder()); - List books = openLibrary.getBooks("Spring Framework"); - System.out.println(books); - List booksByAuthor = openLibrary.getBookTitlesByAuthor("Craig Walls"); - System.out.println(booksByAuthor); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/main/resources/application.properties b/model-context-protocol/book-library/manual-webmvc-server/src/main/resources/application.properties deleted file mode 100644 index 3d554fd..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/main/resources/application.properties +++ /dev/null @@ -1,10 +0,0 @@ -spring.main.web-application-type=SERVLET - -# NOTE: You must disable the banner and the console logging -# to allow the STDIO transport to work !!! -spring.main.banner-mode=off -logging.pattern.console= - -transport.mode=sse - -logging.file.name=mcp.webmvc.log \ No newline at end of file diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientStdio.java b/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientStdio.java deleted file mode 100644 index 8d7914e..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientStdio.java +++ /dev/null @@ -1,39 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.webmvc.client; - -import org.springframework.ai.mcp.client.transport.ServerParameters; -import org.springframework.ai.mcp.client.transport.StdioClientTransport; - -/** - * With stdio transport, the MCP server is automatically started by the client. But you - * have to build the server jar first: 
./mvnw clean install -DskipTests
- */ -public class ClientStdio { - - public static void main(String[] args) { - - var stdioParams = ServerParameters.builder("java") - .args("-Dtransport.mode=stdio", "-Dspring.main.web-application-type=none", "-jar", - "model-context-protocol/mcp-webmvc-server/target/mcp-webmvc-server-0.0.1-SNAPSHOT.jar") - .build(); - - var transport = new StdioClientTransport(stdioParams); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientWebFluxSse.java b/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientWebFluxSse.java deleted file mode 100644 index 60f5609..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/ClientWebFluxSse.java +++ /dev/null @@ -1,32 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.webmvc.client; - -import org.springframework.ai.mcp.client.transport.WebFluxSseClientTransport; -import org.springframework.web.reactive.function.client.WebClient; - -/** - * @author Christian Tzolov - */ -public class ClientWebFluxSse { - - public static void main(String[] args) { - var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/HttpClientSse.java b/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/HttpClientSse.java deleted file mode 100644 index 27f7964..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/HttpClientSse.java +++ /dev/null @@ -1,31 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.webmvc.client; - -import org.springframework.ai.mcp.client.transport.HttpClientSseClientTransport; - -/** - * @author Christian Tzolov - */ -public class HttpClientSse { - - public static void main(String[] args) { - var transport = new HttpClientSseClientTransport("http://localhost:8080"); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/SampleClient.java b/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/SampleClient.java deleted file mode 100644 index e6af73e..0000000 --- a/model-context-protocol/book-library/manual-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/webmvc/client/SampleClient.java +++ /dev/null @@ -1,80 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.webmvc.client; - -import java.util.Map; - -import org.springframework.ai.mcp.client.McpClient; -import org.springframework.ai.mcp.spec.ClientMcpTransport; -import org.springframework.ai.mcp.spec.McpSchema.CallToolRequest; -import org.springframework.ai.mcp.spec.McpSchema.CallToolResult; -import org.springframework.ai.mcp.spec.McpSchema.GetPromptRequest; -import org.springframework.ai.mcp.spec.McpSchema.ListPromptsResult; -import org.springframework.ai.mcp.spec.McpSchema.ListToolsResult; -import org.springframework.ai.mcp.spec.McpSchema.ReadResourceRequest; - -/** - * @author Christian Tzolov - */ - -public class SampleClient { - - private final ClientMcpTransport transport; - - public SampleClient(ClientMcpTransport transport) { - this.transport = transport; - } - - public void run() { - - var client = McpClient.sync(this.transport).build(); - - client.initialize(); - - client.ping(); - - // List and demonstrate tools - ListToolsResult toolsList = client.listTools(); - System.out.println("Available Tools = " + toolsList); - - CallToolResult upperCaseResult = client - .callTool(new CallToolRequest("toUpperCase", Map.of("input", "accountName"))); - System.out.println("Upper case Response = " + upperCaseResult); - - CallToolResult books = client.callTool(new CallToolRequest("getBooks", Map.of("title", "Spring Framework"))); - System.out.println("Books Response = " + books); - - // List and demonstrate resources - var resourcesList = client.listResources(); - System.out.println("\nAvailable Resources = " + resourcesList); - - // Read the system info resource - var systemInfo = client.readResource(new ReadResourceRequest("system://info")); - System.out.println("System Info = " + systemInfo); - - // List and demonstrate prompts - ListPromptsResult promptsList = client.listPrompts(); - System.out.println("\nAvailable Prompts = " + promptsList); - - // Try the greeting prompt - var greetingResponse = client.getPrompt(new GetPromptRequest("greeting", Map.of("name", "Spring"))); - System.out.println("Greeting Response = " + greetingResponse); - - client.closeGracefully(); - - } - -} diff --git a/model-context-protocol/book-library/starter-webflux-server/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/book-library/starter-webflux-server/.mvn/wrapper/maven-wrapper.properties deleted file mode 100644 index d58dfb7..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/.mvn/wrapper/maven-wrapper.properties +++ /dev/null @@ -1,19 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -wrapperVersion=3.3.2 -distributionType=only-script -distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip diff --git a/model-context-protocol/book-library/starter-webflux-server/README.md b/model-context-protocol/book-library/starter-webflux-server/README.md deleted file mode 100644 index 3354c76..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/README.md +++ /dev/null @@ -1,200 +0,0 @@ -# Spring AI MCP WebFlux Server Starter - -This project demonstrates how to create a Spring AI Model Context Protocol (MCP) server using Spring WebFlux. It showcases how to implement MCP tools, resources, and prompts with Spring Boot's auto-configuration capabilities. - -## Overview - -The project provides: -- Spring Boot starter for MCP server implementation -- WebFlux-based transport mode -- Server capabilities: - - Tools support with OpenLibrary integration - - Resources support with system information - - Prompts support with greeting functionality - -## Building the Project - -```bash -./mvnw clean package -``` - -## Running the Server - -The server uses WebFlux transport mode by default: - -```bash -./mvnw spring-boot:run -``` - -## Running the Client Test - -After starting the server, you can run the WebFlux SSE client test located in `src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java`. This test demonstrates how to connect to the server using Spring WebFlux's SSE transport. - -To run the test: -1. Ensure the server is running (previous step) -2. Open `ClientWebFluxSse.java` in your IDE -3. Run the main method in `ClientWebFluxSse` class - -The test creates a WebFlux SSE client that connects to `http://localhost:8080` and demonstrates the client-server interaction using the Model Context Protocol. - -## Available Tools - -### OpenLibrary Tools -The server integrates with the OpenLibrary API to provide book-related functionality: - -#### Get Books by Title -- Description: Get list of Books by title -- Parameters: - - `title`: String - The book title to search for -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("getBooks", Map.of("title", "Spring Framework")) -); -``` - -#### Get Book Titles by Author -- Description: Get book titles by author -- Parameters: - - `authorName`: String - The author name to search for -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("getBookTitlesByAuthor", Map.of("authorName", "Craig Walls")) -); -``` - -### Text Processing Tool -#### toUpperCase -- Description: Converts input text to uppercase -- Parameters: - - `input`: String - The text to convert -- Example: -```java -CallToolResult response = client.callTool( - new CallToolRequest("toUpperCase", Map.of("input", "hello world")) -); -``` - -## Available Resources - -### System Information Resource -- URI: `system://info` -- Description: Provides basic system information including Java version, OS, etc. -- MIME Type: application/json -- Returns: JSON object containing: - - javaVersion - - osName - - osVersion - - osArch - - processors - - timestamp - -## Available Prompts - -### Greeting Prompt -- Name: `greeting` -- Description: A friendly greeting prompt -- Parameters: - - `name`: String (required) - The name to greet -- Returns: A personalized greeting message - -## Configuration - -The application can be configured through `application.properties`: - -```properties -# Server Configuration -spring.ai.mcp.server.enabled=true -spring.ai.mcp.server.name=my-webflux-server-starter -spring.ai.mcp.server.version=0.0.1 -spring.ai.mcp.server.transport=WEBFLUX - -# Logging Configuration (Required for proper operation) -spring.main.banner-mode=off -logging.pattern.console= -logging.file.name=./target/mcp.webflux-server-starter.log -``` - -## Implementation Details - -### Server Configuration -```java -@SpringBootApplication -public class McpServerApplication { - @Bean - public ToolCallbackProvider openLibraryTools(OpenLibrary openLibrary) { - return MethodToolCallbackProvider.builder().toolObjects(openLibrary).build(); - } - - @Bean - public ToolCallback tools(OpenLibrary openLibrary) { - return FunctionToolCallback - .builder("toUpperCase", (Function) s -> s.input().toUpperCase()) - .description("To upper case") - .inputType(ToUpperCaseInput.class) - .build(); - } -} -``` - -### OpenLibrary Integration -```java -@Service -public class OpenLibrary { - @Tool(description = "Get list of Books by title") - public List getBooks(String title) { - // Implementation - } - - @Tool(description = "Get book titles by author") - public List getBookTitlesByAuthor(String authorName) { - // Implementation - } -} -``` - -### Resource Implementation -```java -@Bean -public List resourceRegistrations() { - var systemInfoResource = new McpSchema.Resource( - "system://info", - "System Information", - "Provides basic system information including Java version, OS, etc.", - "application/json", - null - ); - - // Resource registration implementation -} -``` - -### Prompt Implementation -```java -@Bean -public List promptRegistrations() { - var prompt = new McpSchema.Prompt( - "greeting", - "A friendly greeting prompt", - List.of(new McpSchema.PromptArgument("name", "The name to greet", true)) - ); - - // Prompt registration implementation -} -``` - -## Key Features - -1. **Spring Boot Integration**: Leverages Spring Boot's auto-configuration for easy setup -2. **WebFlux Transport**: Uses reactive programming model for efficient request handling -3. **OpenLibrary Integration**: Demonstrates external API integration -4. **System Resource**: Shows how to expose system information as an MCP resource -5. **Function Tools**: Examples of both service-based and function-based tool implementations -6. **Prompt Support**: Implements basic prompt functionality with parameter handling - -## Notes - -- The server is configured to use file-based logging to ensure proper operation of the transport layer -- Banner mode is disabled to prevent interference with the transport protocol -- The OpenLibrary integration demonstrates how to integrate external REST APIs with MCP tools diff --git a/model-context-protocol/book-library/starter-webflux-server/mvnw b/model-context-protocol/book-library/starter-webflux-server/mvnw deleted file mode 100755 index 19529dd..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/mvnw +++ /dev/null @@ -1,259 +0,0 @@ -#!/bin/sh -# ---------------------------------------------------------------------------- -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# ---------------------------------------------------------------------------- - -# ---------------------------------------------------------------------------- -# Apache Maven Wrapper startup batch script, version 3.3.2 -# -# Optional ENV vars -# ----------------- -# JAVA_HOME - location of a JDK home dir, required when download maven via java source -# MVNW_REPOURL - repo url base for downloading maven distribution -# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output -# ---------------------------------------------------------------------------- - -set -euf -[ "${MVNW_VERBOSE-}" != debug ] || set -x - -# OS specific support. -native_path() { printf %s\\n "$1"; } -case "$(uname)" in -CYGWIN* | MINGW*) - [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" - native_path() { cygpath --path --windows "$1"; } - ;; -esac - -# set JAVACMD and JAVACCMD -set_java_home() { - # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched - if [ -n "${JAVA_HOME-}" ]; then - if [ -x "$JAVA_HOME/jre/sh/java" ]; then - # IBM's JDK on AIX uses strange locations for the executables - JAVACMD="$JAVA_HOME/jre/sh/java" - JAVACCMD="$JAVA_HOME/jre/sh/javac" - else - JAVACMD="$JAVA_HOME/bin/java" - JAVACCMD="$JAVA_HOME/bin/javac" - - if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then - echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 - echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 - return 1 - fi - fi - else - JAVACMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v java - )" || : - JAVACCMD="$( - 'set' +e - 'unset' -f command 2>/dev/null - 'command' -v javac - )" || : - - if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then - echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 - return 1 - fi - fi -} - -# hash string like Java String::hashCode -hash_string() { - str="${1:-}" h=0 - while [ -n "$str" ]; do - char="${str%"${str#?}"}" - h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) - str="${str#?}" - done - printf %x\\n $h -} - -verbose() { :; } -[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } - -die() { - printf %s\\n "$1" >&2 - exit 1 -} - -trim() { - # MWRAPPER-139: - # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. - # Needed for removing poorly interpreted newline sequences when running in more - # exotic environments such as mingw bash on Windows. - printf "%s" "${1}" | tr -d '[:space:]' -} - -# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties -while IFS="=" read -r key value; do - case "${key-}" in - distributionUrl) distributionUrl=$(trim "${value-}") ;; - distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; - esac -done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties" -[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties" - -case "${distributionUrl##*/}" in -maven-mvnd-*bin.*) - MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ - case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in - *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; - :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; - :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; - :Linux*x86_64*) distributionPlatform=linux-amd64 ;; - *) - echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 - distributionPlatform=linux-amd64 - ;; - esac - distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" - ;; -maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; -*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; -esac - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" -distributionUrlName="${distributionUrl##*/}" -distributionUrlNameMain="${distributionUrlName%.*}" -distributionUrlNameMain="${distributionUrlNameMain%-bin}" -MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" -MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" - -exec_maven() { - unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : - exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" -} - -if [ -d "$MAVEN_HOME" ]; then - verbose "found existing MAVEN_HOME at $MAVEN_HOME" - exec_maven "$@" -fi - -case "${distributionUrl-}" in -*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; -*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; -esac - -# prepare tmp dir -if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then - clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } - trap clean HUP INT TERM EXIT -else - die "cannot create temp dir" -fi - -mkdir -p -- "${MAVEN_HOME%/*}" - -# Download and Install Apache Maven -verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -verbose "Downloading from: $distributionUrl" -verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -# select .zip or .tar.gz -if ! command -v unzip >/dev/null; then - distributionUrl="${distributionUrl%.zip}.tar.gz" - distributionUrlName="${distributionUrl##*/}" -fi - -# verbose opt -__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' -[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v - -# normalize http auth -case "${MVNW_PASSWORD:+has-password}" in -'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; -has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; -esac - -if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then - verbose "Found wget ... using wget" - wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" -elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then - verbose "Found curl ... using curl" - curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" -elif set_java_home; then - verbose "Falling back to use Java to download" - javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" - targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" - cat >"$javaSource" <<-END - public class Downloader extends java.net.Authenticator - { - protected java.net.PasswordAuthentication getPasswordAuthentication() - { - return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); - } - public static void main( String[] args ) throws Exception - { - setDefault( new Downloader() ); - java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); - } - } - END - # For Cygwin/MinGW, switch paths to Windows format before running javac and java - verbose " - Compiling Downloader.java ..." - "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" - verbose " - Running Downloader.java ..." - "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" -fi - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -if [ -n "${distributionSha256Sum-}" ]; then - distributionSha256Result=false - if [ "$MVN_CMD" = mvnd.sh ]; then - echo "Checksum validation is not supported for maven-mvnd." >&2 - echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - elif command -v sha256sum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - elif command -v shasum >/dev/null; then - if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then - distributionSha256Result=true - fi - else - echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2 - echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 - exit 1 - fi - if [ $distributionSha256Result = false ]; then - echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 - echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 - exit 1 - fi -fi - -# unzip and move -if command -v unzip >/dev/null; then - unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" -else - tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" -fi -printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url" -mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" - -clean || : -exec_maven "$@" diff --git a/model-context-protocol/book-library/starter-webflux-server/mvnw.cmd b/model-context-protocol/book-library/starter-webflux-server/mvnw.cmd deleted file mode 100644 index b150b91..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/mvnw.cmd +++ /dev/null @@ -1,149 +0,0 @@ -<# : batch portion -@REM ---------------------------------------------------------------------------- -@REM Licensed to the Apache Software Foundation (ASF) under one -@REM or more contributor license agreements. See the NOTICE file -@REM distributed with this work for additional information -@REM regarding copyright ownership. The ASF licenses this file -@REM to you under the Apache License, Version 2.0 (the -@REM "License"); you may not use this file except in compliance -@REM with the License. You may obtain a copy of the License at -@REM -@REM http://www.apache.org/licenses/LICENSE-2.0 -@REM -@REM Unless required by applicable law or agreed to in writing, -@REM software distributed under the License is distributed on an -@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -@REM KIND, either express or implied. See the License for the -@REM specific language governing permissions and limitations -@REM under the License. -@REM ---------------------------------------------------------------------------- - -@REM ---------------------------------------------------------------------------- -@REM Apache Maven Wrapper startup batch script, version 3.3.2 -@REM -@REM Optional ENV vars -@REM MVNW_REPOURL - repo url base for downloading maven distribution -@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven -@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output -@REM ---------------------------------------------------------------------------- - -@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) -@SET __MVNW_CMD__= -@SET __MVNW_ERROR__= -@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% -@SET PSModulePath= -@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( - IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) -) -@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% -@SET __MVNW_PSMODULEP_SAVE= -@SET __MVNW_ARG0_NAME__= -@SET MVNW_USERNAME= -@SET MVNW_PASSWORD= -@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*) -@echo Cannot start maven from wrapper >&2 && exit /b 1 -@GOTO :EOF -: end batch / begin powershell #> - -$ErrorActionPreference = "Stop" -if ($env:MVNW_VERBOSE -eq "true") { - $VerbosePreference = "Continue" -} - -# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties -$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl -if (!$distributionUrl) { - Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" -} - -switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { - "maven-mvnd-*" { - $USE_MVND = $true - $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" - $MVN_CMD = "mvnd.cmd" - break - } - default { - $USE_MVND = $false - $MVN_CMD = $script -replace '^mvnw','mvn' - break - } -} - -# apply MVNW_REPOURL and calculate MAVEN_HOME -# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ -if ($env:MVNW_REPOURL) { - $MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" } - $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')" -} -$distributionUrlName = $distributionUrl -replace '^.*/','' -$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' -$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain" -if ($env:MAVEN_USER_HOME) { - $MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain" -} -$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' -$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" - -if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { - Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" - Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" - exit $? -} - -if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { - Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" -} - -# prepare tmp dir -$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile -$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" -$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null -trap { - if ($TMP_DOWNLOAD_DIR.Exists) { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } - } -} - -New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null - -# Download and Install Apache Maven -Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." -Write-Verbose "Downloading from: $distributionUrl" -Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" - -$webclient = New-Object System.Net.WebClient -if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { - $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) -} -[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 -$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null - -# If specified, validate the SHA-256 sum of the Maven distribution zip file -$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum -if ($distributionSha256Sum) { - if ($USE_MVND) { - Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." - } - Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash - if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { - Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." - } -} - -# unzip and move -Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null -Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null -try { - Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null -} catch { - if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { - Write-Error "fail to move MAVEN_HOME" - } -} finally { - try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } - catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } -} - -Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/model-context-protocol/book-library/starter-webflux-server/pom.xml b/model-context-protocol/book-library/starter-webflux-server/pom.xml deleted file mode 100644 index 0dbad54..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/pom.xml +++ /dev/null @@ -1,83 +0,0 @@ - - - 4.0.0 - - org.springframework.boot - spring-boot-starter-parent - 3.3.6 - - - - com.example - - mcp-webflux-server-starter - 0.0.1-SNAPSHOT - - Spring AI MCP StdIO and WebFluxSSE Sample - Sample Spring Boot application demonstrating MCP server usage - - - 1.0.0-SNAPSHOT - - - - - - org.springframework.ai - spring-ai-bom - ${sprign-ai.version} - pom - import - - - - - - - org.springframework.ai - spring-ai-mcp-server-webflux-spring-boot-starter - - - - - - - org.springframework.boot - spring-boot-maven-plugin - - - - - - - Central Portal Snapshots - central-portal-snapshots - https://central.sonatype.com/repository/maven-snapshots/ - - false - - - true - - - - spring-milestones - Spring Milestones - https://repo.spring.io/milestone - - false - - - - spring-snapshots - Spring Snapshots - https://repo.spring.io/snapshot - - false - - - - - \ No newline at end of file diff --git a/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java deleted file mode 100644 index c4bb400..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java +++ /dev/null @@ -1,117 +0,0 @@ -package org.springframework.ai.mcp.sample.server; - -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.function.Consumer; -import java.util.function.Function; - -import com.fasterxml.jackson.databind.ObjectMapper; -import io.modelcontextprotocol.server.McpServerFeatures; -import io.modelcontextprotocol.spec.McpSchema; -import io.modelcontextprotocol.spec.McpSchema.GetPromptResult; -import io.modelcontextprotocol.spec.McpSchema.PromptMessage; -import io.modelcontextprotocol.spec.McpSchema.Role; -import io.modelcontextprotocol.spec.McpSchema.TextContent; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import org.springframework.ai.tool.ToolCallback; -import org.springframework.ai.tool.ToolCallbackProvider; -import org.springframework.ai.tool.ToolCallbacks; -import org.springframework.ai.tool.function.FunctionToolCallback; -import org.springframework.ai.tool.method.MethodToolCallbackProvider; -import org.springframework.boot.SpringApplication; -import org.springframework.boot.autoconfigure.SpringBootApplication; -import org.springframework.context.annotation.Bean; - -@SpringBootApplication -public class McpServerApplication { - - private static final Logger logger = LoggerFactory.getLogger(McpServerApplication.class); - - public static void main(String[] args) { - SpringApplication.run(McpServerApplication.class, args); - } - - public static record ToUpperCaseInput(String input) { - } - - @Bean - public ToolCallbackProvider openLibraryTools(OpenLibrary openLibrary) { - return MethodToolCallbackProvider.builder().toolObjects(openLibrary).build(); - } - - @Bean - public ToolCallback tools(OpenLibrary openLibrary) { - return FunctionToolCallback - .builder("toUpperCase", (Function) s -> s.input().toUpperCase()) - .description("To upper case") - .inputType(ToUpperCaseInput.class) - .build(); - } - - @Bean - public List resourceRegistrations() { - - // Create a resource registration for system information - var systemInfoResource = new McpSchema.Resource( // @formatter:off - "system://info", - "System Information", - "Provides basic system information including Java version, OS, etc.", - "application/json", null - ); - - var resourceRegistration = new McpServerFeatures.SyncResourceRegistration(systemInfoResource, (request) -> { - try { - var systemInfo = Map.of( - "javaVersion", System.getProperty("java.version"), - "osName", System.getProperty("os.name"), - "osVersion", System.getProperty("os.version"), - "osArch", System.getProperty("os.arch"), - "processors", Runtime.getRuntime().availableProcessors(), - "timestamp", System.currentTimeMillis()); - - String jsonContent = new ObjectMapper().writeValueAsString(systemInfo); - - return new McpSchema.ReadResourceResult( - List.of(new McpSchema.TextResourceContents(request.uri(), "application/json", jsonContent))); - } - catch (Exception e) { - throw new RuntimeException("Failed to generate system info", e); - } - }); // @formatter:on - - return List.of(resourceRegistration); - } - - @Bean - public List promptRegistrations() { - - var prompt = new McpSchema.Prompt("greeting", "A friendly greeting prompt", - List.of(new McpSchema.PromptArgument("name", "The name to greet", true))); - - var promptRegistration = new McpServerFeatures.SyncPromptRegistration(prompt, getPromptRequest -> { - - String nameArgument = (String) getPromptRequest.arguments().get("name"); - if (nameArgument == null) { - nameArgument = "friend"; - } - - var userMessage = new PromptMessage(Role.USER, - new TextContent("Hello " + nameArgument + "! How can I assist you today?")); - - return new GetPromptResult("A personalized greeting message", List.of(userMessage)); - }); - - return List.of(promptRegistration); - } - - @Bean - public Consumer> rootsChangeConsumer() { - return roots -> { - logger.info("Registering root resources: {}", roots); - }; - } - -} diff --git a/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java b/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java deleted file mode 100644 index 04d3d93..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java +++ /dev/null @@ -1,82 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.server; - -import java.util.List; -import java.util.Map; - -import org.springframework.ai.tool.annotation.Tool; -import org.springframework.stereotype.Service; -import org.springframework.web.client.RestClient; - -/** - * @author Christian Tzolov - */ -@Service -public class OpenLibrary { - - private RestClient restClient; - - public OpenLibrary() { - this(RestClient.builder()); - } - - public OpenLibrary(RestClient.Builder restClientBuilder) { - this.restClient = restClientBuilder.baseUrl("https://openlibrary.org").build(); - } - - public record Books(Integer numFound, Integer start, Boolean numFoundExact, List> docs) { - } - - public record Book(List isbn, String title, List authorName) { - } - - @Tool(description = "Get list of Books by title") - public List getBooks(String title) { - Books books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search.json").queryParam("q", title).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream() - .map(doc -> new Book((List) doc.get("isbn"), (String) doc.get("title"), - (List) doc.get("author_name"))) - .toList(); - } - - @Tool(description = "Get book titles by author") - public List getBookTitlesByAuthor(String authorName) { - var books = restClient.get() - .uri(uriBuilder -> uriBuilder.path("/search/authors.json").queryParam("q", authorName).build()) - .retrieve() - .body(Books.class); - if (books == null) { - return List.of(); - } - return books.docs.stream().map(doc -> (String) doc.get("top_work")).toList(); - } - - public static void main(String[] args) { - OpenLibrary openLibrary = new OpenLibrary(RestClient.builder()); - List books = openLibrary.getBooks("Spring Framework"); - System.out.println(books); - List booksByAuthor = openLibrary.getBookTitlesByAuthor("Craig Walls"); - System.out.println(booksByAuthor); - } - -} diff --git a/model-context-protocol/book-library/starter-webflux-server/src/main/resources/application.properties b/model-context-protocol/book-library/starter-webflux-server/src/main/resources/application.properties deleted file mode 100644 index 96c96b1..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/main/resources/application.properties +++ /dev/null @@ -1,9 +0,0 @@ -# NOTE: You must disable the banner and the console logging -# to allow the STDIO transport to work !!! -spring.main.banner-mode=off -# logging.pattern.console= -logging.file.name=./model-context-protocol/mcp-webflux-server-starter/target/mcp.webflux-server-starter.log - -spring.ai.mcp.server.name=my-webflux-server-starter -spring.ai.mcp.server.version=0.0.1 - diff --git a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java deleted file mode 100644 index caacea6..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java +++ /dev/null @@ -1,42 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import io.modelcontextprotocol.client.transport.ServerParameters; -import io.modelcontextprotocol.client.transport.StdioClientTransport; - -/** - * With stdio transport, the MCP server is automatically started by the client. But you - * have to build the server jar first: - * - * 
- * ./mvnw clean install -DskipTests
- *
- */ -public class ClientStdio { - - public static void main(String[] args) { - - var stdioParams = ServerParameters.builder("java") - .args("-Dspring.ai.mcp.server.stdio=true", "-Dspring.main.web-application-type=none", - "-Dlogging.pattern.console=", "-jar", - "model-context-protocol/mcp-webflux-server-starter/target/mcp-webflux-server-starter-0.0.1-SNAPSHOT.jar") - .build(); - - new SampleClient(new StdioClientTransport(stdioParams)).run(); - } - -} diff --git a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java b/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java deleted file mode 100644 index 46dfbff..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java +++ /dev/null @@ -1,33 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import io.modelcontextprotocol.client.transport.WebFluxSseClientTransport; - -import org.springframework.web.reactive.function.client.WebClient; - -/** - * @author Christian Tzolov - */ -public class ClientWebFluxSse { - - public static void main(String[] args) { - var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); - - new SampleClient(transport).run(); - } - -} diff --git a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java b/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java deleted file mode 100644 index 9beb9a5..0000000 --- a/model-context-protocol/book-library/starter-webflux-server/src/test/java/org/springframework/ai/mcp/sample/client/SampleClient.java +++ /dev/null @@ -1,80 +0,0 @@ -/* -* Copyright 2024 - 2024 the original author or authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* https://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ -package org.springframework.ai.mcp.sample.client; - -import java.util.Map; - -import io.modelcontextprotocol.client.McpClient; -import io.modelcontextprotocol.spec.ClientMcpTransport; -import io.modelcontextprotocol.spec.McpSchema.CallToolRequest; -import io.modelcontextprotocol.spec.McpSchema.CallToolResult; -import io.modelcontextprotocol.spec.McpSchema.GetPromptRequest; -import io.modelcontextprotocol.spec.McpSchema.ListPromptsResult; -import io.modelcontextprotocol.spec.McpSchema.ListToolsResult; -import io.modelcontextprotocol.spec.McpSchema.ReadResourceRequest; - -/** - * @author Christian Tzolov - */ - -public class SampleClient { - - private final ClientMcpTransport transport; - - public SampleClient(ClientMcpTransport transport) { - this.transport = transport; - } - - public void run() { - - var client = McpClient.sync(this.transport).build(); - - client.initialize(); - - client.ping(); - - // List and demonstrate tools - ListToolsResult toolsList = client.listTools(); - System.out.println("Available Tools = " + toolsList); - - CallToolResult upperCaseResult = client - .callTool(new CallToolRequest("toUpperCase", Map.of("input", "accountName"))); - System.out.println("Upper case Response = " + upperCaseResult); - - CallToolResult books = client.callTool(new CallToolRequest("getBooks", Map.of("title", "Spring Framework"))); - System.out.println("Books Response = " + books); - - // List and demonstrate resources - var resourcesList = client.listResources(); - System.out.println("\nAvailable Resources = " + resourcesList); - - // Read the system info resource - var systemInfo = client.readResource(new ReadResourceRequest("system://info")); - System.out.println("System Info = " + systemInfo); - - // List and demonstrate prompts - ListPromptsResult promptsList = client.listPrompts(); - System.out.println("\nAvailable Prompts = " + promptsList); - - // Try the greeting prompt - var greetingResponse = client.getPrompt(new GetPromptRequest("greeting", Map.of("name", "Spring"))); - System.out.println("Greeting Response = " + greetingResponse); - - client.closeGracefully(); - - } - -} diff --git a/model-context-protocol/weather/manual-webflux-server/pom.xml b/model-context-protocol/weather/manual-webflux-server/pom.xml index 8101dab..5afd7af 100644 --- a/model-context-protocol/weather/manual-webflux-server/pom.xml +++ b/model-context-protocol/weather/manual-webflux-server/pom.xml @@ -19,7 +19,7 @@ Sample Spring Boot application demonstrating MCP client and server usage - 0.7.0-SNAPSHOT + 0.8.0-SNAPSHOT @@ -47,7 +47,7 @@ org.springframework.ai spring-ai-core - + org.springframework.ai spring-ai-mcp @@ -102,6 +102,18 @@ + + Central Portal Snapshots + central-portal-snapshots + https://central.sonatype.com/repository/maven-snapshots/ + + false + + + true + + + spring-milestones Spring Milestones diff --git a/model-context-protocol/weather/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java b/model-context-protocol/weather/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java index 5177182..14f33c6 100644 --- a/model-context-protocol/weather/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java +++ b/model-context-protocol/weather/manual-webflux-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java @@ -3,10 +3,10 @@ package org.springframework.ai.mcp.sample.server; import com.fasterxml.jackson.databind.ObjectMapper; import io.modelcontextprotocol.server.McpServer; import io.modelcontextprotocol.server.McpSyncServer; -import io.modelcontextprotocol.server.transport.StdioServerTransport; -import io.modelcontextprotocol.server.transport.WebFluxSseServerTransport; +import io.modelcontextprotocol.server.transport.StdioServerTransportProvider; +import io.modelcontextprotocol.server.transport.WebFluxSseServerTransportProvider; import io.modelcontextprotocol.spec.McpSchema; -import io.modelcontextprotocol.spec.ServerMcpTransport; +import io.modelcontextprotocol.spec.McpServerTransportProvider; import org.springframework.ai.mcp.McpToolUtils; import org.springframework.ai.tool.ToolCallbacks; @@ -21,23 +21,23 @@ public class McpServerConfig { // STDIO transport @Bean @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "stdio") - public StdioServerTransport stdioServerTransport() { - return new StdioServerTransport(); + public StdioServerTransportProvider stdioServerTransportProvider() { + return new StdioServerTransportProvider(); } // SSE transport @Bean @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public WebFluxSseServerTransport sseServerTransport() { - return new WebFluxSseServerTransport(new ObjectMapper(), "/mcp/message"); + public WebFluxSseServerTransportProvider sseServerTransportProvider() { + return new WebFluxSseServerTransportProvider(new ObjectMapper(), "/mcp/message"); } // Router function for SSE transport used by Spring WebFlux to start an HTTP // server. @Bean @ConditionalOnProperty(prefix = "transport", name = "mode", havingValue = "sse") - public RouterFunction mcpRouterFunction(WebFluxSseServerTransport transport) { - return transport.getRouterFunction(); + public RouterFunction mcpRouterFunction(WebFluxSseServerTransportProvider transportProvider) { + return transportProvider.getRouterFunction(); } @Bean @@ -46,7 +46,7 @@ public class McpServerConfig { } @Bean - public McpSyncServer mcpServer(ServerMcpTransport transport, WeatherApiClient weatherApiClient) { // @formatter:off + public McpSyncServer mcpServer(McpServerTransportProvider transportProvider, WeatherApiClient weatherApiClient) { // @formatter:off // Configure server capabilities with resource support var capabilities = McpSchema.ServerCapabilities.builder() @@ -55,10 +55,10 @@ public class McpServerConfig { .build(); // Create the server with both tool and resource capabilities - McpSyncServer server = McpServer.sync(transport) + McpSyncServer server = McpServer.sync(transportProvider) .serverInfo("MCP Demo Weather Server", "1.0.0") .capabilities(capabilities) - .tools(McpToolUtils.toSyncToolRegistration(ToolCallbacks.from(weatherApiClient))) // Add @Tools + .tools(McpToolUtils.toSyncToolSpecifications(ToolCallbacks.from(weatherApiClient))) // Add @Tools .build(); return server; // @formatter:on diff --git a/model-context-protocol/weather/starter-webmvc-server/src/main/resources/application.properties b/model-context-protocol/weather/starter-webmvc-server/src/main/resources/application.properties index 0988617..e1ab7a4 100644 --- a/model-context-protocol/weather/starter-webmvc-server/src/main/resources/application.properties +++ b/model-context-protocol/weather/starter-webmvc-server/src/main/resources/application.properties @@ -5,7 +5,7 @@ spring.main.banner-mode=off # logging.pattern.console= -spring.ai.mcp.server.stdio=false +# spring.ai.mcp.server.stdio=false spring.ai.mcp.server.name=my-weather-server spring.ai.mcp.server.version=0.0.1 diff --git a/model-context-protocol/weather/starter-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/weather/starter-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java index f820715..4343ab0 100644 --- a/model-context-protocol/weather/starter-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java +++ b/model-context-protocol/weather/starter-webmvc-server/src/test/java/org/springframework/ai/mcp/sample/client/ClientStdio.java @@ -34,7 +34,7 @@ public class ClientStdio { public static void main(String[] args) { System.out.println(new File(".").getAbsolutePath()); - + var stdioParams = ServerParameters.builder("java") .args("-Dspring.ai.mcp.server.stdio=true", "-Dspring.main.web-application-type=none", "-Dlogging.pattern.console=", "-jar",