From dac5e7bd6e45b4eb94eca11b885255ad385e77b3 Mon Sep 17 00:00:00 2001 From: Christian Tzolov Date: Fri, 31 Jan 2025 13:57:43 +0100 Subject: [PATCH] Add MCP weather servers and Brave integration examples Signed-off-by: Christian Tzolov --- mcp.servlet-server.log | 78 ----- mcp.webflux.log | 62 ---- model-context-protocol/README.md | 147 +++++++++ .../.mvn/wrapper/maven-wrapper.jar | Bin 0 -> 58727 bytes .../.mvn/wrapper/maven-wrapper.properties | 2 + .../brave-chatbot/README.md | 115 +++++++ model-context-protocol/brave-chatbot/mvnw | 305 ++++++++++++++++++ model-context-protocol/brave-chatbot/mvnw.cmd | 172 ++++++++++ model-context-protocol/brave-chatbot/pom.xml | 91 ++++++ .../brave-chatbot/spring-ai-mcp-brave.jpg | Bin 0 -> 255575 bytes .../ai/mcp/samples/brave/Application.java | 47 +++ .../src/main/resources/application.properties | 7 + .../main/resources/mcp-servers-config.json | 13 + .../.mvn/wrapper/maven-wrapper.jar | Bin 0 -> 58727 bytes .../.mvn/wrapper/maven-wrapper.properties | 2 + .../brave-starter/README.md | 148 +++++++++ model-context-protocol/brave-starter/mvnw | 305 ++++++++++++++++++ model-context-protocol/brave-starter/mvnw.cmd | 172 ++++++++++ model-context-protocol/brave-starter/pom.xml | 96 ++++++ .../brave-starter/spring-ai-mcp-brave.jpg | Bin 0 -> 255575 bytes .../ai/mcp/samples/brave/Application.java | 38 +++ .../src/main/resources/application.properties | 8 + .../main/resources/mcp-servers-config.json | 13 + .../.mvn/wrapper/maven-wrapper.properties | 19 ++ .../mcp-weather-server-quickstart/README.md | 176 ++++++++++ .../mcp-weather-server-quickstart/mvnw | 259 +++++++++++++++ .../mcp-weather-server-quickstart/mvnw.cmd | 149 +++++++++ .../mcp-weather-server-quickstart/pom.xml | 124 +++++++ .../ai/mcp/sample/client/ClientStdio.java | 64 ++++ .../sample/server/McpServerApplication.java | 23 ++ .../ai/mcp/sample/server/WeatherService.java | 145 +++++++++ .../src/main/resources/application.properties | 14 + .../.mvn/wrapper/maven-wrapper.properties | 19 ++ .../mcp-weather-server-starter/README.md | 175 ++++++++++ .../mcp-weather-server-starter/mvnw | 259 +++++++++++++++ .../mcp-weather-server-starter/mvnw.cmd | 149 +++++++++ .../mcp-weather-server-starter/pom.xml | 133 ++++++++ .../ai/mcp/sample/client/ClientSse.java | 33 ++ .../ai/mcp/sample/client/ClientStdio.java | 48 +++ .../ai/mcp/sample/client/SampleClient.java | 61 ++++ .../sample/server/McpServerApplication.java | 23 ++ .../ai/mcp/sample/server/WeatherService.java | 145 +++++++++ .../src/main/resources/application.properties | 16 + .../.mvn/wrapper/maven-wrapper.properties | 19 ++ .../mcp-weather-server/README.md | 143 ++++++++ .../mcp-weather-server/mvnw | 259 +++++++++++++++ .../mcp-weather-server/mvnw.cmd | 149 +++++++++ .../mcp-weather-server/pom.xml | 123 +++++++ .../ai/mcp/sample/client/ClientSse.java | 33 ++ .../ai/mcp/sample/client/ClientStdio.java | 43 +++ .../ai/mcp/sample/client/SampleClient.java | 61 ++++ .../sample/server/McpServerApplication.java | 13 + .../ai/mcp/sample/server/McpServerConfig.java | 67 ++++ .../mcp/sample/server/WeatherApiClient.java | 144 +++++++++ .../src/main/resources/application.properties | 11 + .../.mvn/wrapper/maven-wrapper.properties | 19 ++ .../mcp-webflux-server-starter/README.md | 193 +++++++++++ .../mcp-webflux-server-starter/mvnw | 259 +++++++++++++++ .../mcp-webflux-server-starter/mvnw.cmd | 149 +++++++++ .../mcp-webflux-server-starter/pom.xml | 124 +++++++ .../ai/mcp/sample/client/ClientStdio.java | 42 +++ .../mcp/sample/client/ClientWebFluxSse.java | 33 ++ .../ai/mcp/sample/client/SampleClient.java | 80 +++++ .../sample/server/McpServerApplication.java | 117 +++++++ .../ai/mcp/sample/server/OpenLibrary.java | 82 +++++ .../src/main/resources/application.properties | 10 + pom.xml | 6 + 67 files changed, 5894 insertions(+), 140 deletions(-) delete mode 100644 mcp.servlet-server.log delete mode 100644 mcp.webflux.log create mode 100644 model-context-protocol/README.md create mode 100644 model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.jar create mode 100644 model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/brave-chatbot/README.md create mode 100755 model-context-protocol/brave-chatbot/mvnw create mode 100755 model-context-protocol/brave-chatbot/mvnw.cmd create mode 100644 model-context-protocol/brave-chatbot/pom.xml create mode 100644 model-context-protocol/brave-chatbot/spring-ai-mcp-brave.jpg create mode 100644 model-context-protocol/brave-chatbot/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java create mode 100644 model-context-protocol/brave-chatbot/src/main/resources/application.properties create mode 100644 model-context-protocol/brave-chatbot/src/main/resources/mcp-servers-config.json create mode 100644 model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.jar create mode 100644 model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/brave-starter/README.md create mode 100755 model-context-protocol/brave-starter/mvnw create mode 100755 model-context-protocol/brave-starter/mvnw.cmd create mode 100644 model-context-protocol/brave-starter/pom.xml create mode 100644 model-context-protocol/brave-starter/spring-ai-mcp-brave.jpg create mode 100644 model-context-protocol/brave-starter/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java create mode 100644 model-context-protocol/brave-starter/src/main/resources/application.properties create mode 100644 model-context-protocol/brave-starter/src/main/resources/mcp-servers-config.json create mode 100644 model-context-protocol/mcp-weather-server-quickstart/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/mcp-weather-server-quickstart/README.md create mode 100755 model-context-protocol/mcp-weather-server-quickstart/mvnw create mode 100644 model-context-protocol/mcp-weather-server-quickstart/mvnw.cmd create mode 100644 model-context-protocol/mcp-weather-server-quickstart/pom.xml create mode 100644 model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java create mode 100644 model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java create mode 100644 model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java create mode 100644 model-context-protocol/mcp-weather-server-quickstart/src/main/resources/application.properties create mode 100644 model-context-protocol/mcp-weather-server-starter/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/mcp-weather-server-starter/README.md create mode 100755 model-context-protocol/mcp-weather-server-starter/mvnw create mode 100644 model-context-protocol/mcp-weather-server-starter/mvnw.cmd create mode 100644 model-context-protocol/mcp-weather-server-starter/pom.xml create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java create mode 100644 model-context-protocol/mcp-weather-server-starter/src/main/resources/application.properties create mode 100644 model-context-protocol/mcp-weather-server/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/mcp-weather-server/README.md create mode 100755 model-context-protocol/mcp-weather-server/mvnw create mode 100644 model-context-protocol/mcp-weather-server/mvnw.cmd create mode 100644 model-context-protocol/mcp-weather-server/pom.xml create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/WeatherApiClient.java create mode 100644 model-context-protocol/mcp-weather-server/src/main/resources/application.properties create mode 100644 model-context-protocol/mcp-webflux-server-starter/.mvn/wrapper/maven-wrapper.properties create mode 100644 model-context-protocol/mcp-webflux-server-starter/README.md create mode 100755 model-context-protocol/mcp-webflux-server-starter/mvnw create mode 100644 model-context-protocol/mcp-webflux-server-starter/mvnw.cmd create mode 100644 model-context-protocol/mcp-webflux-server-starter/pom.xml create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java create mode 100644 model-context-protocol/mcp-webflux-server-starter/src/main/resources/application.properties diff --git a/mcp.servlet-server.log b/mcp.servlet-server.log deleted file mode 100644 index 9d2f21a..0000000 --- a/mcp.servlet-server.log +++ /dev/null @@ -1,78 +0,0 @@ -2025-01-24T19:02:28.340+01:00 INFO 90451 --- [main] .s.a.m.s.s.s.McpServletServerApplication : Starting McpServletServerApplication v0.0.1-SNAPSHOT using Java 23.0.1 with PID 90451 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/mcp-servlet-server/target/mcp-servlet-server-0.0.1-SNAPSHOT.jar started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) -2025-01-24T19:02:28.342+01:00 INFO 90451 --- [main] .s.a.m.s.s.s.McpServletServerApplication : No active profile set, falling back to 1 default profile: "default" -2025-01-24T19:02:28.753+01:00 INFO 90451 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port 8080 (http) -2025-01-24T19:02:28.760+01:00 INFO 90451 --- [main] o.apache.catalina.core.StandardService : Starting service [Tomcat] -2025-01-24T19:02:28.760+01:00 INFO 90451 --- [main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.33] -2025-01-24T19:02:28.779+01:00 INFO 90451 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext -2025-01-24T19:02:28.779+01:00 INFO 90451 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 404 ms -2025-01-24T19:02:29.106+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=initialize, id=d4d5aeb5-0, params={protocolVersion=2024-11-05, capabilities={}, clientInfo={name=Spring AI MCP Client, version=1.0.0}}] -2025-01-24T19:02:29.112+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.server.McpAsyncServer : Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Spring AI MCP Client, version=1.0.0] -2025-01-24T19:02:29.153+01:00 INFO 90451 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http) with context path '/' -2025-01-24T19:02:29.161+01:00 INFO 90451 --- [main] .s.a.m.s.s.s.McpServletServerApplication : Started McpServletServerApplication in 1.034 seconds (process running for 1.272) -2025-01-24T19:02:29.163+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received notification: JSONRPCNotification[jsonrpc=2.0, method=notifications/initialized, params=null] -2025-01-24T19:02:29.164+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=ping, id=d4d5aeb5-1, params=null] -2025-01-24T19:02:29.167+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/list, id=d4d5aeb5-2, params={}] -2025-01-24T19:02:29.177+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=d4d5aeb5-3, params={name=toUpperCase, arguments={input=accountName}}] -2025-01-24T19:02:29.195+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=d4d5aeb5-4, params={name=getBooks, arguments={title=Spring Framework}}] -2025-01-24T19:02:30.723+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/list, id=d4d5aeb5-5, params={}] -2025-01-24T19:02:30.730+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/read, id=d4d5aeb5-6, params={uri=system://info}] -2025-01-24T19:02:30.738+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/list, id=d4d5aeb5-7, params={}] -2025-01-24T19:02:30.744+01:00 INFO 90451 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/get, id=d4d5aeb5-8, params={name=greeting, arguments={name=Spring}}] -2025-01-24T19:02:43.319+01:00 INFO 90643 --- [main] .s.a.m.s.s.s.McpServletServerApplication : Starting McpServletServerApplication using Java 17.0.12 with PID 90643 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/mcp-servlet-server/target/classes started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) -2025-01-24T19:02:43.320+01:00 INFO 90643 --- [main] .s.a.m.s.s.s.McpServletServerApplication : No active profile set, falling back to 1 default profile: "default" -2025-01-24T19:02:43.653+01:00 INFO 90643 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port 8080 (http) -2025-01-24T19:02:43.658+01:00 INFO 90643 --- [main] o.apache.catalina.core.StandardService : Starting service [Tomcat] -2025-01-24T19:02:43.659+01:00 INFO 90643 --- [main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.33] -2025-01-24T19:02:43.683+01:00 INFO 90643 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext -2025-01-24T19:02:43.683+01:00 INFO 90643 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 345 ms -2025-01-24T19:02:44.003+01:00 INFO 90643 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http) with context path '/' -2025-01-24T19:02:44.008+01:00 INFO 90643 --- [main] .s.a.m.s.s.s.McpServletServerApplication : Started McpServletServerApplication in 0.862 seconds (process running for 0.983) -2025-01-24T19:02:47.492+01:00 INFO 90643 --- [http-nio-8080-exec-2] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=initialize, id=7b98b98f-0, params={protocolVersion=2024-11-05, capabilities={}, clientInfo={name=Spring AI MCP Client, version=1.0.0}}] -2025-01-24T19:02:47.496+01:00 INFO 90643 --- [http-nio-8080-exec-2] o.s.ai.mcp.server.McpAsyncServer : Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Spring AI MCP Client, version=1.0.0] -2025-01-24T19:02:47.541+01:00 INFO 90643 --- [http-nio-8080-exec-3] o.s.ai.mcp.spec.DefaultMcpSession : Received notification: JSONRPCNotification[jsonrpc=2.0, method=notifications/initialized, params=null] -2025-01-24T19:02:47.544+01:00 INFO 90643 --- [http-nio-8080-exec-4] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=ping, id=7b98b98f-1, params=null] -2025-01-24T19:02:47.547+01:00 INFO 90643 --- [http-nio-8080-exec-5] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/list, id=7b98b98f-2, params={}] -2025-01-24T19:02:47.557+01:00 INFO 90643 --- [http-nio-8080-exec-6] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=7b98b98f-3, params={name=toUpperCase, arguments={input=accountName}}] -2025-01-24T19:02:47.579+01:00 INFO 90643 --- [http-nio-8080-exec-7] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=7b98b98f-4, params={name=getBooks, arguments={title=Spring Framework}}] -2025-01-24T19:02:49.611+01:00 INFO 90643 --- [http-nio-8080-exec-8] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/list, id=7b98b98f-5, params={}] -2025-01-24T19:02:49.621+01:00 INFO 90643 --- [http-nio-8080-exec-9] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/read, id=7b98b98f-6, params={uri=system://info}] -2025-01-24T19:02:49.630+01:00 INFO 90643 --- [http-nio-8080-exec-10] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/list, id=7b98b98f-7, params={}] -2025-01-24T19:02:49.637+01:00 INFO 90643 --- [http-nio-8080-exec-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/get, id=7b98b98f-8, params={name=greeting, arguments={name=Spring}}] -2025-01-24T19:02:52.594+01:00 ERROR 90643 --- [SpringApplicationShutdownHook] reactor.core.publisher.Operators : Operator called default onErrorDropped - -reactor.core.Exceptions$ErrorCallbackNotImplemented: java.lang.IllegalStateException: The request associated with the AsyncContext has already completed processing. -Caused by: java.lang.IllegalStateException: The request associated with the AsyncContext has already completed processing. - at org.apache.catalina.core.AsyncContextImpl.check(AsyncContextImpl.java:529) ~[tomcat-embed-core-10.1.33.jar:10.1.33] - at org.apache.catalina.core.AsyncContextImpl.complete(AsyncContextImpl.java:92) ~[tomcat-embed-core-10.1.33.jar:10.1.33] - at org.springframework.ai.mcp.server.transport.HttpServletSseServerTransport.removeSession(HttpServletSseServerTransport.java:392) ~[mcp-0.6.0.jar:0.6.0] - at java.base/java.util.concurrent.ConcurrentHashMap$ValuesView.forEach(ConcurrentHashMap.java:4780) ~[na:na] - at org.springframework.ai.mcp.server.transport.HttpServletSseServerTransport.lambda$closeGracefully$4(HttpServletSseServerTransport.java:364) ~[mcp-0.6.0.jar:0.6.0] - at reactor.core.publisher.MonoCreate.subscribe(MonoCreate.java:61) ~[reactor-core-3.6.12.jar:3.6.12] - at reactor.core.publisher.Mono.subscribe(Mono.java:4576) ~[reactor-core-3.6.12.jar:3.6.12] - at reactor.core.publisher.Mono.subscribeWith(Mono.java:4642) ~[reactor-core-3.6.12.jar:3.6.12] - at reactor.core.publisher.Mono.subscribe(Mono.java:4403) ~[reactor-core-3.6.12.jar:3.6.12] - at org.springframework.ai.mcp.spec.McpTransport.close(McpTransport.java:74) ~[mcp-0.6.0.jar:0.6.0] - at org.springframework.ai.mcp.server.transport.HttpServletSseServerTransport.close(HttpServletSseServerTransport.java:336) ~[mcp-0.6.0.jar:0.6.0] - at org.springframework.ai.mcp.spec.DefaultMcpSession.close(DefaultMcpSession.java:296) ~[mcp-0.6.0.jar:0.6.0] - at org.springframework.ai.mcp.server.McpAsyncServer.close(McpAsyncServer.java:396) ~[mcp-0.6.0.jar:0.6.0] - at org.springframework.ai.mcp.server.McpSyncServer.close(McpSyncServer.java:250) ~[mcp-0.6.0.jar:0.6.0] - at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:na] - at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77) ~[na:na] - at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:na] - at java.base/java.lang.reflect.Method.invoke(Method.java:568) ~[na:na] - at org.springframework.beans.factory.support.DisposableBeanAdapter.invokeCustomDestroyMethod(DisposableBeanAdapter.java:316) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DisposableBeanAdapter.destroy(DisposableBeanAdapter.java:249) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.destroyBean(DefaultSingletonBeanRegistry.java:587) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.destroySingleton(DefaultSingletonBeanRegistry.java:559) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DefaultListableBeanFactory.destroySingleton(DefaultListableBeanFactory.java:1202) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.destroySingletons(DefaultSingletonBeanRegistry.java:520) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.beans.factory.support.DefaultListableBeanFactory.destroySingletons(DefaultListableBeanFactory.java:1195) ~[spring-beans-6.1.15.jar:6.1.15] - at org.springframework.context.support.AbstractApplicationContext.destroyBeans(AbstractApplicationContext.java:1195) ~[spring-context-6.1.15.jar:6.1.15] - at org.springframework.context.support.AbstractApplicationContext.doClose(AbstractApplicationContext.java:1156) ~[spring-context-6.1.15.jar:6.1.15] - at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.doClose(ServletWebServerApplicationContext.java:174) ~[spring-boot-3.3.6.jar:3.3.6] - at org.springframework.context.support.AbstractApplicationContext.close(AbstractApplicationContext.java:1102) ~[spring-context-6.1.15.jar:6.1.15] - at org.springframework.boot.SpringApplicationShutdownHook.closeAndWait(SpringApplicationShutdownHook.java:145) ~[spring-boot-3.3.6.jar:3.3.6] - at java.base/java.lang.Iterable.forEach(Iterable.java:75) ~[na:na] - at org.springframework.boot.SpringApplicationShutdownHook.run(SpringApplicationShutdownHook.java:114) ~[spring-boot-3.3.6.jar:3.3.6] - at java.base/java.lang.Thread.run(Thread.java:842) ~[na:na] - diff --git a/mcp.webflux.log b/mcp.webflux.log deleted file mode 100644 index 484584f..0000000 --- a/mcp.webflux.log +++ /dev/null @@ -1,62 +0,0 @@ -2025-01-24T12:29:43.836+01:00 INFO 49430 --- [main] o.s.a.m.s.server.McpServerApplication : Starting McpServerApplication v0.0.1-SNAPSHOT using Java 23.0.1 with PID 49430 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) -2025-01-24T12:29:43.837+01:00 INFO 49430 --- [main] o.s.a.m.s.server.McpServerApplication : No active profile set, falling back to 1 default profile: "default" -2025-01-24T12:29:44.414+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=initialize, id=9ad56cc6-0, params={protocolVersion=2024-11-05, capabilities={}, clientInfo={name=Spring AI MCP Client, version=1.0.0}}] -2025-01-24T12:29:44.422+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.server.McpAsyncServer : Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Spring AI MCP Client, version=1.0.0] -2025-01-24T12:29:44.475+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received notification: JSONRPCNotification[jsonrpc=2.0, method=notifications/initialized, params=null] -2025-01-24T12:29:44.475+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=ping, id=9ad56cc6-1, params=null] -2025-01-24T12:29:44.478+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/list, id=9ad56cc6-2, params={}] -2025-01-24T12:29:44.490+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=9ad56cc6-3, params={name=toUpperCase, arguments={input=accountName}}] -2025-01-24T12:29:44.515+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=9ad56cc6-4, params={name=getBooks, arguments={title=Spring Framework}}] -2025-01-24T12:29:44.520+01:00 INFO 49430 --- [main] o.s.a.m.s.server.McpServerApplication : Started McpServerApplication in 0.91 seconds (process running for 1.157) -2025-01-24T12:29:49.269+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/list, id=9ad56cc6-5, params={}] -2025-01-24T12:29:49.276+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/read, id=9ad56cc6-6, params={uri=system://info}] -2025-01-24T12:29:49.286+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/list, id=9ad56cc6-7, params={}] -2025-01-24T12:29:49.293+01:00 INFO 49430 --- [pool-1-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/get, id=9ad56cc6-8, params={name=greeting, arguments={name=Spring}}] -2025-01-24T19:03:06.765+01:00 INFO 90957 --- [main] o.s.a.m.s.server.McpServerApplication : Starting McpServerApplication v0.0.1-SNAPSHOT using Java 23.0.1 with PID 90957 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) -2025-01-24T19:03:06.767+01:00 INFO 90957 --- [main] o.s.a.m.s.server.McpServerApplication : No active profile set, falling back to 1 default profile: "default" -2025-01-24T19:03:07.174+01:00 INFO 91011 --- [main] o.s.a.m.s.server.McpServerApplication : Starting McpServerApplication v0.0.1-SNAPSHOT using Java 23.0.1 with PID 91011 (/Users/christiantzolov/Dev/projects/spring-ai-examples/model-context-protocol/mcp-webflux-server/target/mcp-webflux-server-0.0.1-SNAPSHOT.jar started by christiantzolov in /Users/christiantzolov/Dev/projects/spring-ai-examples) -2025-01-24T19:03:07.176+01:00 INFO 91011 --- [main] o.s.a.m.s.server.McpServerApplication : No active profile set, falling back to 1 default profile: "default" -2025-01-24T19:03:07.427+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=initialize, id=9e0a3f40-0, params={protocolVersion=2024-11-05, capabilities={}, clientInfo={name=Spring AI MCP Client, version=1.0.0}}] -2025-01-24T19:03:07.433+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.server.McpAsyncServer : Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Spring AI MCP Client, version=1.0.0] -2025-01-24T19:03:07.499+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received notification: JSONRPCNotification[jsonrpc=2.0, method=notifications/initialized, params=null] -2025-01-24T19:03:07.500+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=ping, id=9e0a3f40-1, params=null] -2025-01-24T19:03:07.502+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/list, id=9e0a3f40-2, params={}] -2025-01-24T19:03:07.517+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=9e0a3f40-3, params={name=toUpperCase, arguments={input=accountName}}] -2025-01-24T19:03:07.540+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=9e0a3f40-4, params={name=getBooks, arguments={title=Spring Framework}}] -2025-01-24T19:03:07.628+01:00 INFO 90957 --- [main] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port 8080 (http) -2025-01-24T19:03:07.635+01:00 INFO 90957 --- [main] o.s.a.m.s.server.McpServerApplication : Started McpServerApplication in 1.093 seconds (process running for 1.335) -2025-01-24T19:03:07.841+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=initialize, id=a7f036cf-0, params={protocolVersion=2024-11-05, capabilities={}, clientInfo={name=Spring AI MCP Client, version=1.0.0}}] -2025-01-24T19:03:07.849+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.server.McpAsyncServer : Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Spring AI MCP Client, version=1.0.0] -2025-01-24T19:03:07.904+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received notification: JSONRPCNotification[jsonrpc=2.0, method=notifications/initialized, params=null] -2025-01-24T19:03:07.905+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=ping, id=a7f036cf-1, params=null] -2025-01-24T19:03:07.907+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/list, id=a7f036cf-2, params={}] -2025-01-24T19:03:07.920+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=a7f036cf-3, params={name=toUpperCase, arguments={input=accountName}}] -2025-01-24T19:03:07.946+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=tools/call, id=a7f036cf-4, params={name=getBooks, arguments={title=Spring Framework}}] -2025-01-24T19:03:10.035+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/list, id=a7f036cf-5, params={}] -2025-01-24T19:03:10.045+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/read, id=a7f036cf-6, params={uri=system://info}] -2025-01-24T19:03:10.057+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/list, id=a7f036cf-7, params={}] -2025-01-24T19:03:10.064+01:00 INFO 91011 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/get, id=a7f036cf-8, params={name=greeting, arguments={name=Spring}}] -2025-01-24T19:03:10.070+01:00 WARN 91011 --- [main] onfigReactiveWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Failed to start bean 'webServerStartStop' -2025-01-24T19:03:10.074+01:00 INFO 91011 --- [main] .s.b.a.l.ConditionEvaluationReportLogger : - -Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled. -2025-01-24T19:03:10.083+01:00 ERROR 91011 --- [main] o.s.b.d.LoggingFailureAnalysisReporter : - -*************************** -APPLICATION FAILED TO START -*************************** - -Description: - -Web server failed to start. Port 8080 was already in use. - -Action: - -Identify and stop the process that's listening on port 8080 or configure this application to listen on another port. - -2025-01-24T19:03:10.173+01:00 INFO 91011 --- [parallel-1] o.s.a.m.s.t.StdioServerTransport : Graceful shutdown completed -2025-01-24T19:03:10.180+01:00 INFO 91011 --- [parallel-2] o.s.a.m.s.t.StdioServerTransport : Graceful shutdown completed -2025-01-24T19:03:10.191+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/list, id=9e0a3f40-5, params={}] -2025-01-24T19:03:10.199+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=resources/read, id=9e0a3f40-6, params={uri=system://info}] -2025-01-24T19:03:10.208+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/list, id=9e0a3f40-7, params={}] -2025-01-24T19:03:10.214+01:00 INFO 90957 --- [pool-3-thread-1] o.s.ai.mcp.spec.DefaultMcpSession : Received request: JSONRPCRequest[jsonrpc=2.0, method=prompts/get, id=9e0a3f40-8, params={name=greeting, arguments={name=Spring}}] diff --git a/model-context-protocol/README.md b/model-context-protocol/README.md new file mode 100644 index 0000000..d63c286 --- /dev/null +++ b/model-context-protocol/README.md @@ -0,0 +1,147 @@ +# Spring AI Model Context Protocol (MCP) Examples + +This directory contains various examples demonstrating the usage of Spring AI's Model Context Protocol (MCP). Each example showcases different aspects of MCP implementation, including various transport methods and client-server configurations. + + +## Transport Types + +The examples demonstrate two main types of transport: + +1. **STDIO Transport** + - Process-based communication + - Synchronous communication + - Used in all client examples + - Available in all server implementations + +2. **HTTP SSE (Server-Sent Events) Transport** + - HTTP-based streaming communication + - Asynchronous communication + - Available in server implementations + - Implemented in three variants: + - Servlet-based (Spring MVC) + - WebFlux-based (Reactive) + - WebMVC-based + +## API Types + +The examples demonstrate both synchronous and asynchronous API usage: + +- **Synchronous API**: Used in STDIO transport implementations +- **Asynchronous API**: Used in SSE transport implementations + +## Getting Started + +Each example project can be built using Maven: + +```bash +./mvnw clean install +``` + +For running the examples: +1. For STDIO transport: Run the client application directly +2. For SSE transport: Start the server first, then run the client + +## Note + +- All server implementations support both STDIO and SSE transport modes +- Transport mode can be configured using the `transport.mode` property +- Client examples primarily use STDIO transport for simplicity +- Server starters provide auto-configuration support for easier integration +## Example Projects Overview + +### Current Implementations +These projects use current Spring AI MCP dependencies: + +#### Spring Boot Starter Projects +These use the `spring-ai-mcp-spring-boot-starter` dependency: + +#### `brave-chatbot` +- **Type**: Client +- **Transport**: STDIO +- **Framework**: Spring Boot with MCP Starter +- **Description**: Enhanced version of the Brave client with chatbot capabilities. + +#### `brave-starter` +- **Type**: Client Starter +- **Transport**: STDIO +- **Framework**: Spring Boot with MCP Starter +- **Description**: Spring Boot starter version of the Brave client. + +#### `mcp-webflux-server-starter` +- **Type**: Server Starter +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring WebFlux with MCP Starter +- **Description**: Spring Boot starter for WebFlux server with auto-configuration support. + +#### `mcp-weather-server-quickstart` +- **Type**: Server Quickstart +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring Boot with MCP Starter +- **Description**: Simplified version of the weather server for quick start purposes. + +#### `mcp-weather-server-starter` +- **Type**: Server Starter +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring Boot with MCP Starter +- **Description**: Spring Boot starter version of the weather server, with auto-configuration support. + +#### Manual Configuration Examples +These demonstrate how to create MCP applications without Spring Boot auto-configuration: + +#### `mcp-weather-server` +- **Type**: Server +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring Boot with WebFlux +- **Dependencies**: Uses `spring-ai-bom` and `mcp-bom` for dependency management +- **Description**: Weather service implementation showing how to manually configure an MCP application without using spring-boot-starter. Demonstrates manual configuration patterns while maintaining clean dependency management through BOMs. + +### Legacy Projects (Using Experimental Dependency) +These projects use the experimental dependency `org.springframework.experimental:spring-ai-mcp:0.6.0` and need updating: + +#### Server Implementations + +#### `mcp-servlet-server` +- **Type**: Server +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring MVC +- **Status**: Uses experimental dependency +- **Description**: Demonstrates a server implementation using Spring MVC with servlet-based SSE transport. Includes OpenLibrary integration. + +#### `mcp-webflux-server` +- **Type**: Server +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring WebFlux +- **Status**: Uses experimental dependency +- **Description**: Shows a reactive server implementation using Spring WebFlux with SSE transport. Includes OpenLibrary integration. + +#### `mcp-webmvc-server` +- **Type**: Server +- **Transport**: Supports both HTTP SSE and STDIO +- **Framework**: Spring WebMVC +- **Status**: Uses experimental dependency +- **Description**: Another server implementation using Spring WebMVC, demonstrating SSE transport integration. + +#### Client Examples + +#### `brave` +- **Type**: Client +- **Transport**: STDIO +- **Framework**: Spring Boot +- **Status**: Uses experimental dependency +- **Description**: Client implementation for Brave Search integration. + +#### `filesystem` +- **Type**: Client +- **Transport**: STDIO +- **Framework**: Spring Boot +- **Status**: Uses experimental dependency +- **Description**: Example showing filesystem operations through MCP. + +#### `sqlite` +- **Type**: Client +- **Transport**: STDIO +- **Framework**: Spring Boot +- **Status**: Uses experimental dependency +- **Description**: Demonstrates SQLite database integration through MCP (includes both simple and chatbot variants). + + diff --git a/model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.jar b/model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..c1dd12f17644411d6e840bd5a10c6ecda0175f18 GIT binary patch literal 58727 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%0ANsA|A3-jj|r`KAo%oTajX3>^E` zq{Nq+*dAH{EQyjZw_d4E!54gka%phEHEm}XI5o%$)&Z+*4qj<_EChj#X+kA1t|O3V@_RzoBA(&rgxwAF+zhjMY6+Xi>tw<6k+vgz=?DPJS^! zei4z1%+2HDqt}Ow+|2v^3IZQkTR<&IRxc0IZ_-Di>CErQ+oFQ~G{;lJSzvh9rKkAiSGHlAB$1}ZRdR^v zs2OS)Pca>Ap(RaSs7lM2GfJ#%F`}$!)K4#RaGJ_tY}6PMzY{5uHi}HjU>Qb~wlXQ) zdd(`#gdDgN_cat+Q#1q&iH{`26k}U3UR5(?FXM>Jm{W%IKpM4Jo{`3aEHN)XI&Bwx zs}a_P|M)fwG1Tybl)Rkw#D__n_uM+eDn*}}uN4z)3dq)U)n>pIk&pbWpPt@TXlB?b z8AAgq!2_g-!QL>xdU4~4f6CB06j6@M?60$f;#gpb)X1N0YO*%fw2W`m=M@%ZGWPx; z)r*>C$WLCDX)-_~S%jEx%dBpzU6HNHNQ%gLO~*egm7li)zfi|oMBt1pwzMA$x@ zu{Ht#H}ZBZwaf0Ylus3KCZ*qfyfbTUYGuOQI9>??gLrBPf-0XB84}sCqt5Q(O$M& zoJ+1hx4Wp#z?uex+Q1crm2ai?kci;AE!yriBr}c@tQdCnhs$P-CE8jdP&uriF`WFt>D9wO9fCS0WzaqUKjV_uRWg>^hIC!n-~q=1K87NAECZb^W?R zjbI&9pJ)4SSxiq06Zasv*@ATm7ghLgGw3coL-dn6@_D-UhvwPXC3tLC)q3xA2`^D{ z&=G&aeSCN)6{2W6l@cg&2`cCja~D2N{_>ZQ)(5oSf!ns1i9szOif~I8@;2b)f2yQ5 zCqr{lGy5(^+d!<0g??wFzH^wuv=~0)g55&^7m8Ptk3y$OU|eI7 zIovLvNCoY%N(aW#=_C%GDqEO|hH3O9&iCp+LU=&CJ(=JYDGI;&ag&NKq}d;B`TonC zK+-t8V5KjcmDyMR@jvDs|7lkga4>TQej$5B+>A`@{zE&?j-QbQWk4J*eP2@%RzQ{J z?h`1~zwArwi^D7k9~%xtyf(2&$=GsP*n-fTKneej-y6y(3nNfC7|0{drDx{zz~cSs z<_+d2#ZDst@+`w{mwzmn?dM2aB;E;bS-Opq$%w@WnDwa$hUGL90u9c=as)+_6aO10 zLR|CR8nr<2DQTvkaH0QDsyn@TYCs7Nk3lN}Ix$)JM0*zf=0Ad$w9j723W#%{r8V&`{wx-8kSv#)mZ{FU%UZDIi zvbgLHyJ>z0BZe`GNM$Q;D6D48#zc9s(4^SGr>u-arE}okN62N{zuwX)@FL5>$ib=b z5Wtm~!ojD3X|g59lw%^hE?dL;c^bgVtBOkJxQR{Eb*nR1wVM&fJQ{<))bn9e3bSlu z3E-qpLbAE(S^I4mVn`?lycoV!yO!Qj_4qYgsg7tXR)Gu2%1)5FZu&lY7x>bU`eE}x zSZ5c`z~^&$9V?eEH!^Rp-Fz3WiCvEgf`Tq}CnWRZY+@jZ{2NewmyGUM6|xa3Sh7)v zj6d&NWUVqu9f-&W)tQ>Y%Ea!e76@y!Vm*aQp|wU5u<%knNvHZ!U}`fp*_)mIWba=j z*w9~{f5pD;zCmEWePjM#ERNiNjv!SnM-&rGpB9Nmiv}J+hwB&0f_+x?%*lgJFRHsqfFDPwyvh8<*xLT0u_BeEHw{q+UGj=$4udEx)Vq#sV zKB3+_C!RUKy?ac3-`+}dL2!D_2(5=8&@hBf`-AbU`-<_3>Ilqkg6qSI>9G(@Kx?g<0h0K&31$AR>R%d}{%DyXPss$&c^ja7NR z$0AN7Fl$>VpGxqHW15CjxAa6DUVmCpQNbOwBv8D^Y{bXg28> zEQE9xl?CWh0gS6%Y=G4Cy($Vb>jBb2f_dm#0_B<_Ce`|~Obt_Xp^nkR zK%o_`{h1XkWn}i|5Dp#q8D(;k;2|+{DAG{2gJgPNQ=KZ=FKY@d>QEu6W;oLsE(1}< zpnwSEj(K{Bu^#CXdi7L_$!X`QOx^tA1c{&-XTHo3G?3(H*&VM~*Aud?8%FU=dE&kV zJ$SqZoj^g@(q9x;7B30J$(-qUml{?3e+I^Cf?X0PpLr}m zS}W9`QaCwINRU&D5>j9O*j6S}R1`7{5+{d-xUlI~)U!^4+*b5tkuon-Msz03Z{{Kp zH!GAXoyr#1K;t5o#h#a%Lzj3XQGqM0TRnfu$(fsQe^wb_?W!m!+7r55q>svWN`k~T zS(gk9bi|@+8wg;dR<&0f;MpwQbY27$N{{laPQk3@3uCz$w1&jq)`uW*yn!Pe-V^%Q zR9)cW;UB~ODlwolWFAX?ik#_|v)AtHNwoq72E9Jg#v2e5SErf+7nTleI8&}%tn6hf zuz#5YtRs94Ui&E_1PakHfo+^t-{#ewhO*j5ls-zhm^C{kCARNEB1aORsxE!1SXBRz z6Oc-^#|0W6=7AJ;I|}pH#qby@i^C+Vsu9?zdtkE{0`oO_Hw|N=Lz9Is8j}R zI+8thGK?(KSZ5ZW4nQG1`v(=0Jd*0gIlavVihzo#fPaa=}(Rqdxl3^6O8K+{MqU`;1iTJ$<^k)Nms(A$j?A-wHJKvh9 zUHW3}JkE;x?FETPV8DFTxFLY8eSAd%C8vp?P_EuaMakmyFN_e?Hf|LBctnncUb}zF zIGP4WqtKCydoov~Bi<_I%y%$l+})!;SQVcP?>)9wM3q-GE6t9*LfoePBlo{gx~~e{g_XM5PQ8Y5dsuG%3Xq}I&qcY6 zTCo?<6E%)O$A2torq3-g8j3?GGd){+VHg@gM6Kw|E($M9}3HVIyL1D9321C zu#6~~h<<*=V7*ria%j^d5A;S^E;n!mOnFppfi+4)!BQ@#O2<|WH$RS~)&2Qol|@ff zFR#zmU(|jaqCXPA@q?UhrgbMO7zNXQYA@8$E+;4Bz7g=&zV-)=&08J_noLAz#ngz$ zA)8L8MrbXIDZuFsR_M(DsdX)s$}yH!*bLr{s$YWl5J?alLci=I#p`&MbL4`5bC}=2 z^8-(u4v2hs9*us}hjB!uiiY6vvv&QWJcVLTJ=SFG=lpR+S4Cd91l}oZ+B-*ehY2Ic_85)SRSa% zMEL~a3xrvH8ZnMIC!{9@pfOT7lrhxMf^8N20{CJXg}M35=`50S;6g-JYwjwj!K{^) z5Bohf6_G6z=+0V8&>F8xLbJ4mkCVu^g66#h&?tL z9odv&iW21IAh~y9D-DupKP-NcernF2(*RsFkAsM<$<>@-Cl1?&XAi4+Mh2Zm@2x#u zWH&J^1=8G|`|H2%94bnjUZyI>QACu9FS}^$lbtzzCz4AMspqGYEwFFM<%G!Oc$+;7 z3r_L!H~PR}5n8+3-&4v*fFr$uK{y_VamM0*TKn^))nQsn5U?7Iv?`4|Oy&m6himAG z%=a;2ji3f_RtDPqkwR>ISxhnS0f)E`ITo}TR!zIxPwECZy#jzo%q{BNYtd!<IP_S+=*yDOk1GgwLqe!d9esV@3$iVAm1!8RoE| zqnTz;5a)B(~~KcP)c>?+ysFAlAGF4EBor6)K{K*Kn>B(&QtMAkR^ynG%k%UbJpKM zI$}qQXXP3PISHe_vTFssbcL`irhG2zN7J((3ZFmh*bnPuiK~=#YG=820hXqOON#HI<0bvIT{z&SaqRvqaMG-d5<06zdP?-kIH{%UMR$Xn@S}Hx3 zFjg}6no}vN_512D+RIn-mo9^_Li-)WI5%VigYt{Jd!RyI%d|-LqJU$y3aJ*a$y6$1 zjyTuIF2&t>1rPlw&k5OVLhrYBvk5Vl8T(*Gd?Alqi}> z<@-`X_o@9EOB8Ik&?|;lvKHFU@#O+?T!kEf&oJUaLzN;>!}!!e1WIs(T}V#Irf$AK z42`x`z-9ogxd@%CS;D5S z2M^b;Pu)q)c&_KBO!va-4xnI57L7V@*_I_r4vU)z>xk5z6PDVqg92R7_iZH|VlO_B z#8R`5HZVn?ou>czd>gZ~s;w4ZkzVXJNP8FiezlB5JXe6Z-OLsDw%N7!(135!Vl2Lb zLYI79?U{h#W-_#W6hf`<$BQHJCu5ehv?IF+-uxUqt~j!ZW1cxfiEJal^q7~RMWQ0a z2CEaPa1_p|P6qRmmeKgas*N}@(2tH%U37-<5i(DSnVOFFxg-Sv%7&{hPeRh{U`&ufGz=V|JdYQ2sG5 zk%3JimSwQFP=Yr?u_beSG^B$nnh$4hrxb4lpTTiUFRQEZ3ulr+L3m;>;Io?D;jG6Wjj!b)nsZds<6 zX@cD%+aVr!ra~F7HYr`TB!|y-t)HSb^FQt zbo+_XP44IWJGGxg73JyhBjKMSv`77ngDOw}6Eve6ZIol$Q5s65d(1-sP{BU{1_y)7 zF8sh5A~jxRHk=wq3c5i3*e&otCd9>cstT?IQ&D4slC-&^q!ut1;WAQ}fE}Y+jU}r{ zmpSI%sW?})RAm8}$WUU+V$PmQOF5gSKOGQ2;LF-E(gd<67rYu2K| zom8mOppa%XJ6C(@I7-*opqLn73e9BMFStaBER?suJ{jte1$vA%z?$_`Em=a=(?T-q z*A=VZOQ`P{co!*UUKyV@Rd-c#*wmb7v<%rN=TGFmWmqhbj#&+?X|3bZYAjbNGTv~O zs7SIYi3VgW6@?=PGnbNNZIWaY^*+ChW&a)A$uqH8xxehwx2`<1w6mag?zuHbsVJiO$a)tQ zuBBoR>rLfhpA@)Qf`8BwRMx886%9HP5rOR%YCy9pQ|^Xw!=Mcnwx8j=(ZE)P-tJ&s zON&Nsr%14jS@K+IvrJj720NkCR*C(j&aI$EFCV)w$9M<#LdihyRKdzTjJPI|t9_S} z--#oF#;F?Y1KN%_yE);Bxv}9PWZphz_g5mReOKR`y%9UZ=n}GXWw?E$T1%NAfK1Ad z|0$Lp^;sntA>}=ybW)mkxNv1?hkZ`<8hCemcT5 zYl6$I^bhXDzPlz<>6zOy3Fu*3?>#q$;1fJ>nuxyx#&<&x6Y}j zCU&VmtCJ`;aYN+qP}nwr%s2ZQC|Z**axS^?iGu+x^{{>FIv!k0#HaXtEG=*C7kPe!mMnknbn}TKpp6Xv9 zVvq&%A3nmY^N*XTg&+=wO>(|{uTwm;ZP9@+M)6%T zwXPh-&{+aAfv^ZCzOEb;yj>A=f5Pbu)7T{9PT3u>#w*%?K8jqEF%I>A?q;E%CXn)f z|0ohNa5DMv@HVk^vT(L=HBtH*Vzo81L?)M=g7)>@j*vUx?S zxqZo23n3vn@K-Q@bx3lLT+5=fB_oz8+p?P;@*UU<-u)jb5WFEXzoc+8*EC5P6(HWr zY$mfFr=L&G>(jvl8US2fLQqTzHtAGizfR*;W4-kN2^I>L3KkXgx=e*}+i*N($}{?c zi=Q67G)oEMW{|Gdsm{)|V)5Evo}KLj%}gIe>98FFoNTLrJX z-ACRdewnT1w#Egct%wpGg~q%?!$}>$_UJPC4SP0^)G_$d4jN0jBEx}+rcd*^aDtnx zewG{`m!oSbQ?A~FZ6L{&V0hUE+b$DxjO_;oskFha>@gzy(jDnzGO>z3Tzz|i&Dakg zFid5$;SFxINis^4JzK5XIVabKoP`=ZWp|p|t{hTi8n|#XE=-rINwJ*blo?=%Se(qw zkW7x5Qs(LV5RVGxu2e&4);c73lY#0(iZo1x=MY;7mW`uUQIY+$_PqH`4a`6O#urwU zE6(FrvyExmB{c5z*YAj_P&t??F1t6TN2N!$N#~02u(t(PDVyD)$mL3hqKQ4E91N#GOIngPr&pUb-f_Z4*XV8`p1pq+mzrUlUY=4~i|3RDo;Lo36U}uwm zaOah}mO8c@%J*~~{Up7_7->8|3x<}WemgaMA}h>xD17Fey@V9;LgjQFSBS(A<+2kCP9( zlkD%;oXzWtZ_hgu0IxeTjH`6=vi|t_04Btl32=g8swD1oZguWr4|lx0RuXoDHbh27 z+ks?gkVWYnr~_{h+PzQjQ(#8kaJai4We{F!JuqCzU0t*+H{n6i3;K<>_6XUn1n)}) zJ?}JCUPYhT9S1Hi-M+$(Z**%fz7Z%IiMN6%kD>wh%r4#C?Ge4{>w9o??Vbehy9!3@ zffZs8?LGxyWQr@yB(|%~Aa>fVj3$O=i{K*f;?h-a@-ce{(cY8qByOCA1r0;NC}}gr zcC^fCa$Ot`42n>`ehclOAqBo7L&D6Mi=;M5!pd@jj$H z?U7LQWX_u7bHpBzF7L-s4*`C)`dUrbEIgKy5=QHsi7%#&WYozvQOXrNcG{~HIIM%x zV^eEHrB=(%$-FXVCvH@A@|nvmh`|agsu9s1UhmdPdKflZa7m&1G`3*tdUI5$9Z>*F zYy|l8`o!QqR9?pP4D7|Lqz&~*Rl-kIL8%z?mi`BQh9Pk9a$Z}_#nRe4NIwqEYR(W0 z1lAKVtT#ZTXK2pwfcCP%Apfo#EVU|strP=o4bbt3j zP?k0Bn$A&Xv$GTun3!izxU#IXsK1GQt;F0k`Tglr{z>v2>gCINX!vfs`aqag!S*AG5Z`y-# zUv_u&J4r;|EA`r!-gsoYGn<^nSZLH-nj1SRGc0MRG%LWVL)PckFn9z!ebIJ}eg+ix zIJo7GN;j1s$D6!({bYW)auypcB~eAWN;vhF%(l=|RR})$TOn;ldq^@8ZPi<%Xz~{Z zQQ|KAJ@JHaX!Ka2nhP%Cb^I}V6_C|e1SjOQpcPMMwfNz#U@Az|+rmH*Zn=cYJu-KR z{>f++Z~P=jm)4-7^yc#52U4qeNcBRYb!hhT3Q7Ngu5t@CvY*ygxu^Eh?2l6= zhdqN{QEaP(!p>1p1*toD!TllHH6EH~S%l9`mG62dyAd+?}1(vf@N*x^6vhEFU<-RqS7#12*q-xtU z5d|F^n%WSAQHnm-vL)4L-VvoUVvO0kvhpIg57Wf@9p;lYS5YfrG9jtrr?E<_JL{q% z7uPQ52{)aP{7<_v^&=J)?_|}Ep*`{dH-=cDt*65^%LodzPSH@+Z~;7sAL}ZECxQv+;z*f;(?k)>-Lp@jBh9%J`XotGJO(HcJc!21iZ98g zS-O!L9vpE(xMx1mf9DIcy8J5)hGpT!o|C8H4)o-_$BR!bDb^zNiWIT6UA{5}dYySM zHQT8>e*04zk1)?F99$dp5F^2Htt*jJ=( zH(#XwfEZ`EErdI~k(THhgbwNK9a(()+Ha1EBDWVRLSB?0Q;=5Y(M0?PRJ>2M#uzuD zmf5hDxfxr%P1;dy0k|ogO(?oahcJqGgVJmb=m16RKxNU3!xpt19>sEsWYvwP{J!u& zhdu+RFZ4v8PVYnwc{fM7MuBs+CsdV}`PdHl)2nn0;J!OA&)^P23|uK)87pmdZ@8~F$W)lLA}u#meb zcl7EI?ng$CAA;AN+8y~9?aon#I*BgYxWleUO+W3YsQxAUF@2;Lu-m#U?F(tFRNIYA zvXuKXpMuxLjHEn&4;#P|=^k+?^~TbcB2pzqPMEz1N%;UDcf{z2lSiwvJs(KhoK+3^2 zfrmK%Z-ShDHo^OUl@cfy#(cE=fZvfHxbQ!Chs#(vIsL%hf55_zyx>0|h2JT=|7JWo z+Uth3y@G;48O|plybV_jER4KV{y{$yL5wc#-5H&w(6~)&1NfQe9WP99*Kc+Z^!6u7 zj`vK@fV-8(sZW=(Si)_WUKp0uKT$p8mKTgi$@k}(Ng z#xPo-5i8eZl6VB8Bk%2=&`o=v+G7g|dW47~gh}b3hDtjW%w)47v#X!VYM}Z7hG1GI zj16;ufr@1^yZ*w3R&6pB8PMbuz%kQ%r=|F4+a!Gw2RBX6RD5c!3fU@+QCq#X7W@Q5 zuVQ}Uu0dzN+2mSX5)KV%CsU;2FL%B6YT`10$8JR^#;jOO1x?t()Q_gI zxpQr2HI0_^@ge0hNt&MQAI`yJ1Zhd-fpR{rdNmRkEEDu7SpB)QOP4ajV;UBZZZK<6 zWds;!f+|}iP-kqWAH#1@QisJpjcg`+s80!LhAG@(eMad|zcln~oE8}9l5!K{^zf~( zd=HArZ5+Mryc$uNa`@|GSdOX=y}8GZc-%p8W@OM)uk2DfmhQXCU1E#y3XJ>|+XdW2 z)FQLeK38}u_D(5E{GV|YT^rI4qds2{-r<@@@@SG@u&4LbC z5o|KKqVM{?wk$5>2?t*I?IHdh~gljn_2m2zqZNJEEz4Mb$o&I3_UAg#$B{0u$uF4-q}{ zzs5+k@qOe08!CGLGmy3eRrcuqsgB*B>i8c3>3=T^Hv>nL{{u)jtNc6tLbL7KxfUr; z=Pp14Nz+ggjuwd~*oRJ)xWwGwdge+~b!E%c3Gzw6`vT>CCxE0t6v5Z`tw1oKCcm68A~Dbc zgbhP6bkWwSQ=#5EsX*O9Sm^}EwmQQzt2V2phrqqe2y)w8;|&t6W?lUSOTjeU%PKXC z3Kw$|>1YrfgUf6^)h(|d9SRFO_0&Cvpk<+i83DLS_}jgt~^YFwg0XWQSKW?cnBUVU}$R9F3Uo;N#%+js-gOY@`B4+9DH zYuN|s&@2{9&>eH?p1WVQcdDx&V(%-kz&oSSnvqzcXC3VsggWet1#~bRj5lBJDo#zF zSz))FHQd8>3iSw{63m`Pgy_jkkj9LTmJ&!J(V0E~&}HJ4@nXp<(miz$sb;(I<8s!7 zZyezu!-+X81r03486gAlx@n#aKx_93DREBtNcYln*8oliQ zbh0~SkAgHXX%C6}HwN(TRwaK2k_$Y}PxKId;jYt=S1Bf<8s@(IL?k3u1(f^V%TYO1 zA_jPf*V)SLEZFWS#y>M&p$LoSk+%ubs`)H%WEZf=F)RKh&x;i)uLIGJ94~A4m$(;S z;1rQC{m>--`WHFcaFA&5#7~vz|5S;{fB(7pPnG;@$D~C0pZYNEG?B8X*GB2e4{Qk; za1oop8OvHqs1Lk6B`AuYOv4`y`IgM315iTr{VUVc9WeOG;xE z%eDQgE4rb_B%vuT>N?^K zRvPnQwG%7RjO26+DY!OXWjgBu4^!)W-+ob_G&nX++))pD->QdRCo0spZN?Y*J#@-q z)fk-fJvZYz8)GSxYc^oXYIM;Pw}ftHW+a3dis#dXx^OS^m-~FlwcVr6MXv78fNI!i z51K-2t&!&IZ4(GF=mT@;qIp!&R(I@UiWPPz)%Us&(FdAAGxZ-+6^UZ7em`J-F#_3r zLkHym@VAnZFM$J~?0b@&O`l4YXyvOQ+OqalbZ0{g{qD{neY_xno1ZpXlSJWM=Mv(~ zvK{?O>AcXpbd}+hn{~*>weZwDTURX*M^9RkOO#DUfRW1;comKg1bn+mlsrNY8XDyW zgWg9~AWb_1^D8zsD4bL(1J4oinVy0Fimrh&AC}Itl;IH*p4eU_I;SWkOI!9tAbi3B zO@0=q#LHAc>z?ve8Q&hsF(sR9lgf_99_5Kvuug<^&0}Y&m)YjI?bITGIuh}AJO|>z zc*`Mly$>TA={AIT#d%JuMpXHDt($qkc*3UTf-wS$8^awqDD^|EAeA{FoeyJfWM@QX zk>vJ4L|8DU7jg_fB^3Qvz*V$QmDl*AXdw6@KSckh#qxjLCM8Nba!dTkJgr(S@~Z0a zt8%|W!a~3zG4Y&X6xbLtt^JK5;JT($B`_9bv(BjRTfG_Y`tg3k-}%sQoY@F|=}}${ zwmW%Ub6jPd)$;NA0=b7w!^2dE-qvI4)AVr`yvkabJcGwvuQ2rAoRlTjvCC^-$2BG} ziy0<6nt8;J67rymwm&wVZ8E7Krouv2Ir@-GQ%ui6PR42KHKms3MK&Z$zp{_XAVvrd znK4cbg)Ggh5k(4SlFOM9yyRUlVH1oo%|6Lu9%ZxZW28!c9Z%H5#E?B?7H7ulcUtirB<{s@jnS(-R@we z^R#{Mn$#JXd~5sw9rU&~e3fYTx!T&hY{S<~7hviG-T$<4OPcG6eA0KOHJbTz^(`i~ z_WON4ILDLdi}Ra@cWXKLqyd0nPi06vnrU-)-{)Xp&|2gV>E{Uc>Td`@f@=WYJYZ^- zw&+fjnmyeRoK-unBVvX>g>wO3!ey<+X#z@8GNc9MD}khMO>TV{4`z zx4%!9|H6k|Ue;`M{G6d!p#LL+_@6WMpWgF7jk*%$D_JB3c%D`~YmHRJD1UNDLh;Tf zYbbKcv9R(81c4yK+g+1Ril{5w#?E}+NVz>d@n48C-T-(L?9a9W`JV*{dan-sH*P3_Hnt~iRv)}ye;7$b}^4l%ixphDK`G#b!4R4qoouT@*A zZ)kQa)e94??k7N>tqoRl>h(9DFq&92=z|F!LJrh-97EoFL|Wt2v}>(zG1*#aiYA_^ zM_&%_G^g*O8x650e>m!#MDmwRub!irY>^^|L=!4^%lBr;?}mvgP3y~^mSdKSm^R~WAt7T0_ck0mA`GS)J^SYTo6^vQ|vuM7!92&@$BhtcQ^Z4h2)aN zh~EQthyjn1(eI~$FtuHH!|x(iHU{9k40k5nPBwB)X@8Lo$P6u81EeoNOGRct%a-LM_4y3Ts z7ki0PWAO^Es6c%M*SSRn)2|NAoUsKyL%))uVx7?5lkrk`njxs4q@M~x+8%jr7xV;- z|KC=g3aTZO|y|g~oHXB6b42(|J_&fP2Y`*;L07H2d>{~JP zFNGl$MYUG(Qy3dR?9Bfdg8#peGRiVP8VYn@)6T1bj*v)s6q*7<6P(ZVm4ZnTA;rOHSd>P`_5uT0+azWdV`gIvLaJ1o*DB}&W6LCgX|BycgF5qd z!)}dT#A~4*6{1=Bd5VV(Qa2h4x9m#2X711z(ZN>i&cn`BopG*5P`CD*HfYiQmXNGk zhgqcHPBrJP$Z@PLZ4}d-8^}%X^LtUDHq&;~3}lUyrxxl@|IS={GP&6-qq&Iy5gKW- zC@$}`EEZd}DOSeSD+v_x5r_tpBWfN0gDa21p(@TAIrgWQFo7NO@slI6XOAML_lN;3 zEv~}LlMbGWKu}0s$tO-vR)wD!=olGcA?}vU;lRu4+Zf z?nCD7hBmA5`U9P#W8-*0V1=OT-NI0k&_`UZ87DbpYq_=DBdyNDchZ<|V1f%dbaa7i zf~R+6Xt%G)VXlM@8REfP3u#7UPadWYOBMsQ56fHRv!0p9R6q>Rbx!n|IY0goLb%{+ zzy|5WXk+(d@ChzOWatIV1lc1F!(uEOfEmMd;v`|$Kt3X2Uws;%@OV!E86PN?CeHV& z=4#TX{J8RWaH`)!J<8AUs#Ar{6Am^8M{S( zc%K7y2YbcLUz+*eDTXdthNE)Lm^P&*e^eV zilOS9)TVKgr9_^_M!TJ^44v<YF2NO=h(oOr5jYxVTxWk0XJ8n0{F_SOH%49WMk*Sg7`g6B(=^< z*rLAW;8I5;1?;Fh{N=f;kxjLpj}u^mD|k8lih|G4#}wEG1j`HIG( z8y;BMR3cE01e?(+k8NLR|Z+)#>qR^iMZc=BkcixWSKYmkaHpIFN?s%*74kc&wxwB zrtbYBGz9%pvV6E(uli6j)5ir%#lQkjb3dvlX*rw5tLv#Z>OZm@`Bf2t{r>u^&lRCg z11*w4A;Lyb@q~I(UQMdvrmi=)$OCVYnk+t;^r>c#G8`h!o`YcqH8gU}9po>S=du9c*l_g~>doGE0IcWrED`rvE=z~Ywv@;O-##+DMmBR>lb!~_7 zR`BUxf?+5fruGkiwwu|HbWP^Jzui=9t^Pmg#NmGvp(?!d)5EY<%rIhD=9w5u)G z%IE9*4yz9o$1)VZJQuppnkY)lK!TBiW`sGyfH16#{EV>_Im$y783ui)a;-}3CPRt- zmxO@Yt$vIOrD}k_^|B2lDb2%nl2OWg6Y)59a?)gy#YtpS+gXx?_I|RZ&XPO`M!yl7 z;2IS@aT4!^l`Tped5UGWStOw5PrH#`=se%(ox%gmJUBk18PsN$*-J8S%r51Y$i!4N zQ!rW%cgj44jA~_x%%smSTU2WG_W0c&PB$A5*kl8{$|865+lSIX~uyDT`uI7qnS!BPAg1Wwrc0e)8Usf zv9^E38H&hWSp5!@K8Qinl|)9 zEB?NMaxZK^GB!PUf1TBw+`H&jFSNI=Q@v5$Ryf-y^#IuXO#vsM5R+9@qz#z0fD0GP z9|Hj#E>?<=HTcsF$`xn`je~D&3kF1Qi%dfH{sKh!~(IpgjkDGQn zQx2F9rv{*x2$(@P9v?|JZY)^b9cd+SO6_1#63n-HAY3fE&s(G031g2@Q^a@63@o?I zE_^r%aUvMhsOi=tkW;}Shom;+Nc%cdktxtkh|>BIneNRGIK{m_1`lDB*U=m|M^HGl zWF#z8NRBduQcF-G43k2-5YrD}6~rn2DKdpV0gD%Kl{02J{G3<4zSJ1GFFSXFehumq zyPvyjMp2SLpdE5dG#@%A>+R3%AhLAwyqxjvGd{I7J`Iw{?=KKPRzyrdFeU}Qj{rm{351DoP_;vx zMo*s+!Gwgn;${(LXXO(xyI@$ULPZI|uzYR%`>MmW6Hcr1y2aM5b$grFwW_(9Fzz$Q z$&8dKNdWvBkK=iYWA|0}s1B7>8J$g*Ij_+S9vC1#jy~uA8nr)yY)a+ zoJ=e>Lp`7v3^tQN<&6UpDi{c1b}F~fJ$9r=p=@U^J_7bOck$5}ncVjYB0yEjbWrhe@E`j64yN3X?=k_F3BalH$aN zV=94?wDNv=BKLB<1*xU|65Zl!%51r5sHQ?qCggCw;$2QfCZ$lN40WPL=n^{Prf^QS zjbZ&1MRGgiZ2T)}DpiluFr#q*!AZJ$1v#d10YQ{>wQ5px!y28-1hCZ7lwvQnQYN*U zOg9BpvB0A$WUzFs+KWk1qLiGTrDT-0>DUpFl??l(FqWVz_3_Xzqg9vTpagp- zZcJ!5W?|0G%W|AJVVHJ7`u6@<4yyqMGHj@kpv`P+LV<)%PM__Rz&oq~t-*vV12@NR zoEVPz<2D>O==MlNI`;l8Gmv49&|1`FR!}2`NLRCqA{@`imLz6zrjS4ui0)O;!Pu&?KPAcX)?tDPS26uKvR(ry(p{6kiXPoZbnQ!vx6dLu zZCaj~Ocr$h##KqsD;9;ZiUwhmUd%5lrwczWr1Yn6V>+IK=>51;N7JDkrm1NY-ZBes z;FxeOTb^HAyA+~P2}WvSSu_fzt_K=(m4wUp%c*^hF zEJ+1dP0{0B8bryXR+qApLz43iu?ga<5QQxTa$1gMCBq0W=4|DTv4nY4T*-^Im%>U~ z)98;hc(d7vk0zAML$WnPWsqK>=O-FZSLI3_WQKr*PCK=(i6LelZ$$}XXrD5cb~VXz zT%egX>8e;KZs@jcD>cL9VP(Q}b0r~ST$Mc%mr1cC8mqRUQc|N^9@Weu$Z|KeczK7HhSFeFV0i)MQmwrn7CBL=p`_9n?nh320m}6-MSv3L7I*<*56GR zZ`zI^1zyC7F#*zVL@M)F2+oqxydaiQz?|ODmqs|Ub8%&KXk9P3P7<4tM?X{~!;Ygw zt=h7)AYGDO9F&wV=BhCyD9exr#YM_-<;Fo~iE>IBEXK$%;JCUAEr;lR&3S_DUy_E) z#!oCYdENVE9OaaeaIrPk-odMtvdFG;ocA#`L6AifMu0og^?Oy9F|Et9q6 z8;3_|9+Io@hqYoN;58x1K&OP!9Vd#dzhTRjB2kI?%31ceHb#Q~WqJV5lw;@b>4@Rd z={z1S`d05YdWC*RLc7sR0bVGSytn-a3`JZL3|d8KC?vj_70Vi4ohP9QbU&Q4?Zjd0 zSZA?KbqLBsJg(qj>fycto3`zN-)lDe4{Ij-QfoBn@rT_tTszA+CnM~xWmE(4zfpCQ z;zPJfl3=ctrggYM!KQg;V{J;utMMF9&BfOe!<{wU0ph?-VQ%cv3B%fFiW?6xBPdf0 zD-HhEU?0C`G@7e+b-=8fj=TP3mdz&SIQ}Nd`*G#DTz9Y@b zaoDF}Gx7ZhPzpDhi^fA7WZ)EAEFv;N2*bKp0T za0t<^1|Zc#`A+?s$!$8eO4CK~PUFECC3BwNR4f)!V&-Y>$xg(%T{MtrH|CPcO(Lf> zE_meE1?6S-qlV^p2fh! zT11Ub)hHw!_mpFDMIAFB`%Yal+`1IXV>b?%!q^Ps%8nh8wtjVGlF-!5x*D29WJ4=M zZ7X(QvKe$YZNgM(HibD7+VO5Q29?@HzS?k$c|3B@JI6dlLgu5S&LbU4=4p-Yn||z@ z4p05vq*k*pbOV9QjVTMp8`c$?t@~!$8&5AP_sz@tk%a$nWHMh-Gm{WS5+q)5W6pU# za@YZXJCLTpZ}zb=$HCYbIm->?Hu6XIBz_d7)n1+3eSLzGVoNQCTHcu9qS2@({0sxc zu<-mhx@Xz_*(S1DEL|d0`YV7uNevL*Y6|DAQmvSp{4DzPL@>hqJ?`FjvIU;<&}YEKDmFUGSBYjRmK{Km-1m%-t=fFfI9kV|POH|SxvO=P+><+1JK_lt5F6fTPf8PXU+lYEJz__** z&>`4F2F8EWE+k7ZsZx9%!?A56{lsk1juYw5zN)V+g$d^Q^Gm}fnHKA6L^36=`e;p% zp{;JD$X3%}O7qINR*2<>a422}_hmc=)-A7B-1#2v85jN5K31t0DtmqON-Dim`XIR; zOo`KRv)gtn?stp*`^f>}UDnGYGnJAbl(4srd>(5fo2#oqi>#bus86EHfeItFIu$+% z;lE|3gjQA`BXHEE5JdcjCoethN`@NEc~zm6CYf@LJ|hT^1>l}gRl7oDHMnw!*5*IC z@@Mi=gO=lZSnWln`dX^4Bd{9zYG{HNIX-87A#5OM%xu*%V?7K3j3CHcN*t!zNK4N4 z!U2?a>0`8m8}UQshILC0g6-k>8~;SRIJ?vQKDj z@U{DrstWIT7ufyRYox^&*IyHYb$3wtB}V^0sS|1OyK#sDc%sh+(gy&NT9j4Aa7J0C zPe$02TylMjad&|{_oe3`zx)Cqns?6qThYue6U=~j5+l0Po4`bX*&9V@a<-O;;vCzm z(af&;e<^}?5$7&MRW$eb*P< zX|33QmDvFSDFK-qMz|RF|Eedum@~W zt~8C1@i8@LammTr)rAgKm8X_SczCg@+@LeWpcmx;VL;iLQJ;t%Z*|XbNWUnHX|o=Q z%bsXc%bw=pk~8%3aV-w(7E$co9_cHQ$!}Ep6YcoCb7~GQBWl#4D!T8A5!P*tSl4FK zK2CX0mjmosg6TSK@-E-He{dm0?9h{&v~}OX15xgF<1-w4DCypYo22%@;uRq`ZFld- z{Uqof@a@P5dW@kfF-`1B1(!R>(DHb&$UXY%Gd+6r?w8klhP&ldzG*6#l#VuM&`)ki z)f$+Rp?YYog9u==<#MC%1daG#%3EOX9A{7$`_(s#_4mV`xZaB+6YlX`H4{}vq;)TF zo~fR@do6EZIR?413A$V6o^fq&QV7P(bB(9m1969szOosyhZRYciAWXe4@u-}s(LeJpuIkSx)XvjXmvVEseG zJvWN4s|$6r;s(3F+cgeh4DMEq??h!$eb^5h#`whT5d03qfYpol8dCim)A^NG1-H}} z!b)V8DTL2Q8@R2p`y4@CeSVj9;8B5#O?jfl-j<$Quv?Ztwp*)GvQ~|W8i6?-ZV@Lf z8$04U_1m{2|AIu+rd8KW`Qk|P1w(}d%}cjG6cxsTJ3Y&*J^_@bQgXwILWY7w zx+z)v81rZv-|mi>y#p$4S7AA760X?)P&0e{iKcWq4xvv@KA@EWjPGdt8CKvh4}p}~ zdUVzuzkBlU2Z+*hTK214><61~h~9zQ3k+-{Pv~w`#4|YdjTFKc{===9Ml7EMFmE!f zH}U3O{Z`DuJrBZbz~OjSVlD6uZSEeNK8epja_LanEh8v;_$Eg9?g*9ihMoat$#qd^ z?;x?a*y3-pW#6|kF^<$w;2^~s!fc;3D~#&#WYZfK@3;bO{MvmN?>qy%_%v`BVCgfC zdwL~(H14Gr6w(1CX|R;zhZh%?*Q{hxJH`MV2)@Jg$pbqjZeL+LO7^vwgi!@3yn@NT zU91-{;BWIi8bV-j-YR|A9Qs?M?e7Ru&Onl1(Sz(kxAw?LEbd+Le%Z43rZgb2h2m|e z^rblc;4r+}?@tC(YIBB_qpQL?_kg{;zO#6JD9{;HSUgf@zIZ)}Bh4wFZIs>meSd}f z4iF~nD$KAV6CVEw+{YOPrW~~y~Y=?snG4dE3edN$~SXh`!c_F zUsQ1M;ARz&v0mIbfP}aLWZ&cBPU+DU{l+0}_>9DZGL{@}lF6QCtgAg;EWUu`D$Evm znblG}kC!}Mw)bR~U;+S}T9TVc6lXWR!LNMm)nmxr*ORkv#&UO$_WQpt0WdX{A=bjC zV^lB~(r;y!C4$Rk0fWUR|09O?KBos@aFQjUx{ODABcj}h5~ObwM_cS>5;iI^I- zPVEP9qrox2CFbG`T5r_GwQQpoI0>mVc_|$o>zdY5vbE~B%oK26jZ)m=1nu_uLEvZ< z8QI_G?ejz`;^ap+REYQzBo}7CnlSHE_DI5qrR!yVx3J1Jl;`UaLnKp2G$R__fAe;R(9%n zC)#)tvvo-9WUBL~r_=XlhpWhM=WS6B0DItw{1160xd;M(JxX_-a&i%PXO@}rnu73_ zObHBZrH%R!#~pjEp~P?qIj4MdAx@sv;E96Doi$eO-~)oUz%Z0Tr4K`-jl06Il!9{s zdjF*1r{XU?)C(%XKPm;UnpnDGD%QL3pgo0ust~+sB0pa|v37>E1dp*Odn)n=DY;5j zDzSAkU9B6F$;|##_mrDe#%hd7pC1u`{9ZKeDdtkyl&4>H=e)Fq@}$UffPt1#cjYZg zd%O%xpg4~brEr>AnKT)kF@`cdX4tMlZ#Vk!l1Xz!G970p`Gkv^lk-|>jmt0W5Wu6woGf?hNA zXO2?BG)<{`NsYAY#3|L^x*=rS7uWU~s<*UhTC8AYc#lGP-=Aw1I)@y(<` znQb^nL~$rlDbsdAc4nc#{+$_;Z4iY;Pi0i9Q;>ZB3+IjWLg_r40-Fso^xF<*_s7Tj zujFrMH{vW3PmCndjQIscnQE%`Qj|E2kidi#c&PcWIMyH+e#7!l`<$_)*pDP$!49pY6w!bN)j8~A1wV%gIakf+vA04 zV)_Q=QMPSj6$M2Ar#KhhxsbZUOq3nZHh8m0?Fr}I6N(Fk zkhXM(f57yOa8vn^97J+g9ISPa=-**6^8ZX&g=z+m&6~x<1>)MyM&tpbWhSf8#+Pcd4rVK#)NSw>1eLKHTO z44A@sc_}Ypi#ggFRbDRFV(IhOnRU&XPrQYh9`mVMo-^U$&AwsXooSRUFqJ7)XUXCK zFpt;gJ}9QTN9xy9$=3OnRkjgUuQZ`X)!}LBm~WUIEKuK-Z%}f?2?+MKucWU<3)>9G zxsz~2pHut1AmH<@66;LdCB9+dSpojE4ggrYS?%icv*Rpi?G0Q($^`(g<1&Z){O_5B$@f#;I2-+Qa1P$a@=u-vOY5vqo z|6G67X;*A|V86ZET9OpFB&02twZtc2K}~ASoQpM_p{vJ{-XvA8UmQa4Ed%fS{D@g( zr_aY0gKw*=2SIGznXXKFo$r0x3)@bq8@4od^U(L0-jvTsK@qYOWX?2G_>N+?;r{TU2{M>V0zid zB_Zu?WSnRl@k?oE*gsgv;jH@+ z-}BDGyR-ls7$dz{e( ztv7lI2|OxNkLD4zc3xGA`!d7LiSdOys4H!8aA(_c0Nm*uLjS4TW%Z3v>am1nwQ_lI zIs85Uufd;cv-(4wi(Js;QsL#|qdv)n;r_?puaK*1>zTC@d=#sK+q1YF_Q(5B%%3TtI8&bNs_e8vIb;oc|Rk`F~u?|A?jj{c={?{Env{mW#q@8 z)#WEgt4B6b&X2?o3=b`ilz;)-h$t4;hsxPDo-%5C(7m#c9tZF-U`vcx0HnVtf_X(}4Tg}4wx(=y!@T7{)4;I_p95mBhikg-|U9z35q`|!1+Zz@97 z(PFE5jCv|=t;^=(CLqYp)k90rV4ZSiFDAhD8YOCzv{}1WDuB?epORibW36);q(Aig ze27@D?lN-ZyjuB4GsebA$;+(KGiOtCe6Bfd%GKRty>dBS1GUe}MXgnu61UdgO=m1& zE(eECPF_%J-lU{;R)eQJot;;}Wch$-8Z|lxN*AAdc;bkpbD`W}F=Z}^Cy(SKyfF#+ zQSalA%JDDAu|77$M3E|kv==3vx~pFPw_<+9xgcE#oigh*>#QsA2}sTYO7uY(h@dhR zHJBi^bb-`1?<1cGFZJa8Akzs{H^$N<)5@hlXeKwt9hD5^5K&`pdHOI92p<7XhS?>| z(5h9KYctN|H+W~Xh2N4W+yjMyBm(AdewjX?PBuRU$^J zS#+U($K6rhFFzf z0q*kJ>B6xI1qAti?H@X@dxtB7_vT+Nj@PNxr?CSK#xqE6jh5S{`nH#zzvjOId=i1X zK(Yjl!7KF(73GXYLVkQA5irn|v-ArCqwi)CM8X&m!#@NQ3bqmQlfurU4qT`zl_m^C zhpk?mfVvy9L|)*+bW8&NY4lG$@0_PKfO9+~(zrbn?wECGi7472W{H&dRPZum^Qf z73C-TR6$#q>XJgYnUgV!WkbmRas;`TY#7CxPXIEGwT6VPBDKbyr#|C2M%q|7l#Ql< zuM}j=2{D+?SxT8?ZJn&Z%cRN8Gu@y(`zV(lfj1T%g44(d#-g&@O0FL5;I9=?bW>!M z%c3J&e}GThdean-<||jUh zlLP`UeKBhhrQ?HHjM3}kfO7Z=EKB%+rs*t+nuBoeuD2yk%n32SA?-s)4+DsTV7U&K zyKQO2b2*tQT}#((=#fkb%hkRkt^%tY&VK$hcs91+hld zJ%lgC!ooILC&|(Z9$zzk=Q0*%&l7wwyf%nv=`C=OcPjb|Q%@9*XkPGFrn+bxp?t^D z!_qO=e-;bnT)^0d|Ex9X&svN9S8M&R>5l*5Df2H@r2l)VfBO@LqeVw`Fz6TSwAt^I z5Wu6A>LNnF7hq4Ow=7D7LEDv3A))d5!M=lT3ConlFN`5eTQMexVVs* zH0tx-*R+-B@&Lp`0V4j6Uy=LJmLQRY_6tH4vnV{_am%kkv|{CYkF}4Wn6U+|9Xre$ zJkO;_=dtw`@aEs|^GlO-zvpp-73H;PYk}V5RrH83G4SVkRJ0YSluQa8pKejcqB4u~ z^9^lDR|?7vEo|jITtaIFI6}1;vTI6n(d0kDGQUJuk>>sqdd7#VBF;?_dM5i<+VMEq zc>habJK}_0eEsOkdwv48d43jKMnqYFMnYDU&c?vi#Fp+S)sxo1-oVJ*g!X^^K! z>z!G8?KfU{qOnLHhaEF4QRHgOpfvoo7@=FG(2ZefYJk- zZuA9ubiTTP9jw9Uzpx8FfJBFt+NNE9dTlM!$g$|lTD za4LMNxWhw8!AV(x;U`IV-(bK@iQ%#QSmq8D$YqLgt?V#|~% z;{ST}6aQbOoewMKYzZT@8|Qq z@9SNBu1UErolMjrhJW-Id&7y<0I<+Z-lr`IHMh1;M)n@g|hx_T-maO`s{Tuhax}EjC zS;1kdL*A3BW5YZXgD|0zm)g3_3vMs>5xgHUhQDl19lfQWMcfLTsw$)amgDs>bW*Oe+$UK^`ioL%F0Ua5vb%II+EGS>*I zw)AmqcWBZpWH&Aswk_FJT=J|^Gn=MfnDTIzMdnoRUB91MeW?e>+C)g3_FDN8rN$(? zL+kH!*L}rq`MK`KDt^v4nUJg3Ce-`IW0Ph0?|}Puq5WIS_a7iEO;~mGQqqo=Ey;ND zhBXA^$ZrCc#&0}dMA&@)&TCq5PMzgJPafZCg-6$R zRqJ2+_t+dGUAY@~xPzU3`od7-(8nnuMfM-4#u`Q~`l-CUGC7u*^5VwH`ot;Ck#R1% zRr%?;!NrB$w^}NW=GGR}m!3a9bh#wXrq?fF7j-IS?E_!GaD3KYzcXhCUHhjEl-6b# zCmIF#4y@HN=^#uIz zRFl8D)Ri1<(Kr~Hoi_MtXWP8^AyTKxi1)ew88bV{*Ok8w8YLXBFW0sRJ<(vU{$ym| zz)feLQbz3k;_}2_{-bW`h~t&2$ObtlbS?k2k|5Kbu?FZLDMTVW_Z6p#A)c)`3DD?a*hxHS2Zj zcIiebfsINfWvwY7Z{YOlIQ61b`j=%6{>MPs+`()Q{wq0z0?|jwRN(1IrMQsj40BHx zvBC_Xfcr;55&}MeoP_@#nz$avCh%FJfE5NNAE~fW@L7~f8Y=?Wno31128EYOK8+O! zc4Vaj-DCsB6CPH$?pQQVbb_(tg^x{$STYM_WKLtrh-_-Hq-M%Ubpt6$mCHY!B{ISD zz}grIo^bNVDw4={SA2*nDNq5`e@ZO5r4TbQpHM)~qfD9!s0h(Jf>vYd;I~j<2fD4)_>ctbwNX6S*8>i^*4 zYKI5<4}d;hM!!N|A$@eg09J|HV;!UUVIau_I~dxZp#?a3u0G)pts6GKdCNk>FKxdh_`Xu!>zO3Kv?u+W6cYJPy!@=PuY868>3|Zg} z$7galV~M`d!q(`I{;CJsq6G9>W0}H6gVY`q7S@9s8ak1r{>}*Q0JyH&f!f8(NZxhC zkn|KS64r^A1fniFel2KkxYByk%erCx9UgFLI)`yuA)X z8SU?6kj!numPNCAj}>1ipax(t{%rxU;6`(Nqt$~Z4~76TQ$9d8l`yJ}rniII%HbH= zlS_7o!qB{55at^>N!Voer%)`KMh9Yd@Z?~nc19*hs)NGN954`O9zA&&vJHbm&|D@E za(&z6A=3NfC;>I)hlI@ulP8E@W-ziGe{iCf_mHvWGldxw8{ng-hI({EtOdALnD9zG ze)fU?I(DNt)Bzdd9Cs^>!|+2!xv1SK=I zJ+y_;=Sq-zqD~GKy@{5(my&aPgFfGY&_mayR_)?dF_^Fwc-n!UAG+fQQGfjWE-1MF YM{}PByk10KD_nuQ4E7Du?}+~TKh4V)`~Uy| literal 0 HcmV?d00001 diff --git a/model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..b7cb93e --- /dev/null +++ b/model-context-protocol/brave-chatbot/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,2 @@ +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.4/apache-maven-3.8.4-bin.zip +wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar diff --git a/model-context-protocol/brave-chatbot/README.md b/model-context-protocol/brave-chatbot/README.md new file mode 100644 index 0000000..512d221 --- /dev/null +++ b/model-context-protocol/brave-chatbot/README.md @@ -0,0 +1,115 @@ +# Spring AI - Model Context Protocol (MCP) Brave Search Chatbot + +This example demonstrates how to build an interactive chatbot that combines Spring AI's Model Context Protocol (MCP) with the [Brave Search MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search). The application creates a conversational interface powered by Anthropic's Claude AI model that can perform internet searches through Brave Search, enabling natural language interactions with real-time web data. + + + +## Prerequisites + +- Java 17 or higher +- Maven 3.6+ +- npx package manager +- Anthropic API key (Claude) +- Brave Search API key (Get one at https://brave.com/search/api/) + +## Setup + +1. Install npx (Node Package eXecute): + First, make sure to install [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) + and then run: + ```bash + npm install -g npx + ``` + +2. Clone the repository: + ```bash + git clone https://github.com/spring-projects/spring-ai-examples.git + cd model-context-protocol/brave-chatbot + ``` + +3. Set up your API keys: + ```bash + export ANTHROPIC_API_KEY='your-anthropic-api-key-here' + export BRAVE_API_KEY='your-brave-api-key-here' + ``` + +4. Build the application: + ```bash + ./mvnw clean install + ``` + +## Running the Application + +Run the application using Maven: +```bash +./mvnw spring-boot:run +``` + +The application will start an interactive chat session where you can ask questions. The chatbot will use Brave Search when it needs to find information from the internet to answer your queries. + +## How it Works + +The application integrates Spring AI with the Brave Search MCP server through several components: + +### MCP Client Configuration + +1. Required dependencies in pom.xml: +```xml + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + org.springframework.ai + spring-ai-anthropic-spring-boot-starter + +``` + +2. Application properties (application.properties): +```properties +spring.ai.mcp.client.stdio.enabled=true +spring.ai.mcp.client.stdio.servers-configuration=classpath:/mcp-servers-config.json +spring.ai.anthropic.api-key=${ANTHROPIC_API_KEY} +``` + +3. MCP Server Configuration (mcp-servers-config.json): +```json +{ + "mcpServers": { + "brave-search": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-brave-search" + ], + "env": { + "BRAVE_API_KEY": "${BRAVE_API_KEY}" + } + } + } +} +``` + +### Chat Implementation + +The chatbot is implemented using Spring AI's ChatClient with MCP tool integration: + +```java +var chatClient = chatClientBuilder + .defaultSystem("You are a useful assistant, expert in AI and Java.") + .defaultTools((Object[]) mcpToolAdapter.toolCallbacks()) + .defaultAdvisors(new MessageChatMemoryAdvisor(new InMemoryChatMemory())) + .build(); +``` + +Key features: +- Uses Claude AI model for natural language understanding +- Integrates Brave Search through MCP for real-time web search capabilities +- Maintains conversation memory using InMemoryChatMemory +- Runs as an interactive command-line application + +The chatbot can: +- Answer questions using its built-in knowledge +- Perform web searches when needed using Brave Search +- Remember context from previous messages in the conversation +- Combine information from multiple sources to provide comprehensive answers diff --git a/model-context-protocol/brave-chatbot/mvnw b/model-context-protocol/brave-chatbot/mvnw new file mode 100755 index 0000000..eb65ff2 --- /dev/null +++ b/model-context-protocol/brave-chatbot/mvnw @@ -0,0 +1,305 @@ +#!/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. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Maven2 Start Up Batch script +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# M2_HOME - location of maven2's installed home dir +# MAVEN_OPTS - parameters passed to the Java VM when running Maven +# e.g. to debug Maven itself, use +# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +# MAVEN_SKIP_RC - flag to disable loading of mavenrc files +# ---------------------------------------------------------------------------- + +if [ -z "$MAVEN_SKIP_RC" ] ; then + + if [ -f /etc/mavenrc ] ; then + . /etc/mavenrc + fi + + if [ -f "$HOME/.mavenrc" ] ; then + . "$HOME/.mavenrc" + fi + +fi + +# OS specific support. $var _must_ be set to either true or false. +cygwin=false; +darwin=false; +mingw=false +case "`uname`" in + CYGWIN*) cygwin=true ;; + MINGW*) mingw=true;; + Darwin*) darwin=true + # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home + # See https://developer.apple.com/library/mac/qa/qa1170/_index.html + if [ -z "$JAVA_HOME" ]; then + if [ -x "/usr/libexec/java_home" ]; then + export JAVA_HOME="`/usr/libexec/java_home`" + else + export JAVA_HOME="/Library/Java/Home" + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=`java-config --jre-home` + fi +fi + +if [ -z "$M2_HOME" ] ; then + ## resolve links - $0 may be a link to maven's home + PRG="$0" + + # need this for relative symlinks + while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG="`dirname "$PRG"`/$link" + fi + done + + saveddir=`pwd` + + M2_HOME=`dirname "$PRG"`/.. + + # make it fully qualified + M2_HOME=`cd "$M2_HOME" && pwd` + + cd "$saveddir" + # echo Using m2 at $M2_HOME +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --unix "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --unix "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --unix "$CLASSPATH"` +fi + +# For Mingw, ensure paths are in UNIX format before anything is touched +if $mingw ; then + [ -n "$M2_HOME" ] && + M2_HOME="`(cd "$M2_HOME"; pwd)`" + [ -n "$JAVA_HOME" ] && + JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" +fi + +if [ -z "$JAVA_HOME" ]; then + javaExecutable="`which javac`" + if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then + # readlink(1) is not available as standard on Solaris 10. + readLink=`which readlink` + if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then + if $darwin ; then + javaHome="`dirname \"$javaExecutable\"`" + javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" + else + javaExecutable="`readlink -f \"$javaExecutable\"`" + fi + javaHome="`dirname \"$javaExecutable\"`" + javaHome=`expr "$javaHome" : '\(.*\)/bin'` + JAVA_HOME="$javaHome" + export JAVA_HOME + fi + fi +fi + +if [ -z "$JAVACMD" ] ; then + 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" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + else + JAVACMD="`which java`" + fi +fi + +if [ ! -x "$JAVACMD" ] ; then + echo "Error: JAVA_HOME is not defined correctly." >&2 + echo " We cannot execute $JAVACMD" >&2 + exit 1 +fi + +if [ -z "$JAVA_HOME" ] ; then + echo "Warning: JAVA_HOME environment variable is not set." +fi + +CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher + +# traverses directory structure from process work directory to filesystem root +# first directory with .mvn subdirectory is considered project base directory +find_maven_basedir() { + + if [ -z "$1" ] + then + echo "Path not specified to find_maven_basedir" + return 1 + fi + + basedir="$1" + wdir="$1" + while [ "$wdir" != '/' ] ; do + if [ -d "$wdir"/.mvn ] ; then + basedir=$wdir + break + fi + # workaround for JBEAP-8937 (on Solaris 10/Sparc) + if [ -d "${wdir}" ]; then + wdir=`cd "$wdir/.."; pwd` + fi + # end of workaround + done + echo "${basedir}" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + echo "$(tr -s '\n' ' ' < "$1")" + fi +} + +BASE_DIR=`find_maven_basedir "$(pwd)"` +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +########################################################################################## +# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +# This allows using the maven wrapper in projects that prohibit checking in binary data. +########################################################################################## +if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found .mvn/wrapper/maven-wrapper.jar" + fi +else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." + fi + if [ "$MVNW_REPOURL" = true]; then + jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + else + jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + fi + while IFS="=" read key value; do + case "$key" in (wrapperUrl) jarUrl="$value"; break ;; + esac + done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Downloading from: $jarUrl" + fi + wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" + if $cygwin; then + wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` + fi + + if command -v wget > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found wget ... using wget" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget "$jarUrl" -O "$wrapperJarPath" + else + wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" + fi + elif command -v curl > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found curl ... using curl" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl -o "$wrapperJarPath" "$jarUrl" -f + else + curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f + fi + + else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Falling back to using Java to download" + fi + javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaClass=`cygpath --path --windows "$javaClass"` + fi + if [ -e "$javaClass" ]; then + if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Compiling MavenWrapperDownloader.java ..." + fi + # Compiling the Java class + ("$JAVA_HOME/bin/javac" "$javaClass") + fi + if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + # Running the downloader + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Running MavenWrapperDownloader.java ..." + fi + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} +if [ "$MVNW_VERBOSE" = true ]; then + echo $MAVEN_PROJECTBASEDIR +fi +MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" + +# For Cygwin, switch paths to Windows format before running java +if $cygwin; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --path --windows "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --windows "$CLASSPATH"` + [ -n "$MAVEN_PROJECTBASEDIR" ] && + MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` +fi + +WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +exec "$JAVACMD" \ + $MAVEN_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/model-context-protocol/brave-chatbot/mvnw.cmd b/model-context-protocol/brave-chatbot/mvnw.cmd new file mode 100755 index 0000000..4f5150a --- /dev/null +++ b/model-context-protocol/brave-chatbot/mvnw.cmd @@ -0,0 +1,172 @@ +@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 Maven2 Start Up Batch script +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM M2_HOME - location of maven2's installed home dir +@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands +@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a key stroke before ending +@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven +@REM e.g. to debug Maven itself, use +@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files +@REM ---------------------------------------------------------------------------- + +@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' +@echo off +@REM set title of command window +title %0 +@REM enable echoing my setting MAVEN_BATCH_ECHO to 'on' +@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% + +@REM set %HOME% to equivalent of $HOME +if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") + +@REM Execute a user defined script before this one +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre +@REM check for pre script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" +if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" +:skipRcPre + +@setlocal + +set ERROR_CODE=0 + +@REM To isolate internal variables from possible post scripts, we use another setlocal +@setlocal + +@REM ==== START VALIDATION ==== +if not "%JAVA_HOME%" == "" goto OkJHome + +echo. +echo Error: JAVA_HOME not found in your environment. >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +:OkJHome +if exist "%JAVA_HOME%\bin\java.exe" goto init + +echo. +echo Error: JAVA_HOME is set to an invalid directory. >&2 +echo JAVA_HOME = "%JAVA_HOME%" >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +@REM ==== END VALIDATION ==== + +:init + +@REM Find the project base dir, i.e. the directory that contains the folder ".mvn". +@REM Fallback to current working directory if not found. + +set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% +IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir + +set EXEC_DIR=%CD% +set WDIR=%EXEC_DIR% +:findBaseDir +IF EXIST "%WDIR%"\.mvn goto baseDirFound +cd .. +IF "%WDIR%"=="%CD%" goto baseDirNotFound +set WDIR=%CD% +goto findBaseDir + +:baseDirFound +set MAVEN_PROJECTBASEDIR=%WDIR% +cd "%EXEC_DIR%" +goto endDetectBaseDir + +:baseDirNotFound +set MAVEN_PROJECTBASEDIR=%EXEC_DIR% +cd "%EXEC_DIR%" + +:endDetectBaseDir + +IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig + +@setlocal EnableExtensions EnableDelayedExpansion +for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a +@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% + +:endReadAdditionalConfig + +SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" +set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" +set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + +FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B +) + +@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +@REM This allows using the maven wrapper in projects that prohibit checking in binary data. +if exist %WRAPPER_JAR% ( + echo Found %WRAPPER_JAR% +) else ( + if not "%MVNW_REPOURL%" == "" ( + SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + ) + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %DOWNLOAD_URL% + + powershell -Command "&{"^ + "$webclient = new-object System.Net.WebClient;"^ + "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ + "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ + "}"^ + "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ + "}" + echo Finished downloading %WRAPPER_JAR% +) +@REM End of extension + +%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* +if ERRORLEVEL 1 goto error +goto end + +:error +set ERROR_CODE=1 + +:end +@endlocal & set ERROR_CODE=%ERROR_CODE% + +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost +@REM check for post script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" +if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" +:skipRcPost + +@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' +if "%MAVEN_BATCH_PAUSE%" == "on" pause + +if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% + +exit /B %ERROR_CODE% diff --git a/model-context-protocol/brave-chatbot/pom.xml b/model-context-protocol/brave-chatbot/pom.xml new file mode 100644 index 0000000..5b31838 --- /dev/null +++ b/model-context-protocol/brave-chatbot/pom.xml @@ -0,0 +1,91 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.3.6 + + + com.example + ai-mcp-brave-chatbot + 0.0.1-SNAPSHOT + Spring AI - Model Context Protocol - Brave + Simple AI Application using MCP client to use Brave for Internet search + + 17 + + + + + + org.springframework.ai + spring-ai-bom + 1.0.0-SNAPSHOT + pom + import + + + + + + + org.springframework.boot + spring-boot-starter + + + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + + org.springframework.ai + spring-ai-anthropic-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/libs-milestone-local + + false + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + + \ No newline at end of file diff --git a/model-context-protocol/brave-chatbot/spring-ai-mcp-brave.jpg b/model-context-protocol/brave-chatbot/spring-ai-mcp-brave.jpg new file mode 100644 index 0000000000000000000000000000000000000000..27fdc4b8452f699bfdb945b5f4cd4ff55b4826d9 GIT binary patch literal 255575 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

)T^$I;7tRMc%!6>^cUU< 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%0D}F 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 Z=U|{KMOpas-_H#H%;|4yfkVFx|1XX{-Y@_F literal 0 HcmV?d00001 diff --git a/model-context-protocol/brave-chatbot/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java b/model-context-protocol/brave-chatbot/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java new file mode 100644 index 0000000..e21c7fd --- /dev/null +++ b/model-context-protocol/brave-chatbot/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java @@ -0,0 +1,47 @@ +package org.springframework.ai.mcp.samples.brave; + +import java.util.List; +import java.util.Scanner; + +import org.springframework.ai.chat.client.ChatClient; +import org.springframework.ai.chat.client.advisor.MessageChatMemoryAdvisor; +import org.springframework.ai.chat.memory.InMemoryChatMemory; +import org.springframework.ai.tool.ToolCallback; +import org.springframework.boot.CommandLineRunner; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.context.annotation.Bean; + +@SpringBootApplication +public class Application { + + public static void main(String[] args) { + SpringApplication.run(Application.class, args); + } + + @Bean + public CommandLineRunner chatbot(ChatClient.Builder chatClientBuilder, List tools) { + + return args -> { + + var chatClient = chatClientBuilder + .defaultSystem("You are useful assistant and can perform web searches Brave's search API to reply to your questions.") + .defaultTools(tools) + .defaultAdvisors(new MessageChatMemoryAdvisor(new InMemoryChatMemory())) + .build(); + + // Start the chat loop + System.out.println("\nI am your AI assistant.\n"); + try (Scanner scanner = new Scanner(System.in)) { + while (true) { + System.out.print("\nUSER: "); + System.out.println("\nASSISTANT: " + + chatClient.prompt(scanner.nextLine()) // Get the user input + .call() + .content()); + } + } + + }; + } +} \ No newline at end of file diff --git a/model-context-protocol/brave-chatbot/src/main/resources/application.properties b/model-context-protocol/brave-chatbot/src/main/resources/application.properties new file mode 100644 index 0000000..903f1d7 --- /dev/null +++ b/model-context-protocol/brave-chatbot/src/main/resources/application.properties @@ -0,0 +1,7 @@ +spring.application.name=mcp +spring.main.web-application-type=none + +spring.ai.anthropic.api-key=${ANTHROPIC_API_KEY} + +spring.ai.mcp.client.stdio.enabled=true +spring.ai.mcp.client.stdio.servers-configuration=classpath:/mcp-servers-config.json \ No newline at end of file diff --git a/model-context-protocol/brave-chatbot/src/main/resources/mcp-servers-config.json b/model-context-protocol/brave-chatbot/src/main/resources/mcp-servers-config.json new file mode 100644 index 0000000..df98809 --- /dev/null +++ b/model-context-protocol/brave-chatbot/src/main/resources/mcp-servers-config.json @@ -0,0 +1,13 @@ +{ + "mcpServers": { + "brave-search": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-brave-search" + ], + "env": { + } + } + } +} \ No newline at end of file diff --git a/model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.jar b/model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..c1dd12f17644411d6e840bd5a10c6ecda0175f18 GIT binary patch literal 58727 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%0ANsA|A3-jj|r`KAo%oTajX3>^E` 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 YM{}PByk10KD_nuQ4E7Du?}+~TKh4V)`~Uy| literal 0 HcmV?d00001 diff --git a/model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..b7cb93e --- /dev/null +++ b/model-context-protocol/brave-starter/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,2 @@ +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.4/apache-maven-3.8.4-bin.zip +wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar diff --git a/model-context-protocol/brave-starter/README.md b/model-context-protocol/brave-starter/README.md new file mode 100644 index 0000000..ef78492 --- /dev/null +++ b/model-context-protocol/brave-starter/README.md @@ -0,0 +1,148 @@ +# Spring AI - Model Context Protocol (MCP) Brave Search Example + +This example demonstrates how to use the Spring AI Model Context Protocol (MCP) with the [Brave Search MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search). The application enables natural language interactions with Brave Search, allowing you to perform internet searches through a conversational interface. + + + +## Prerequisites + +- Java 17 or higher +- Maven 3.6+ +- npx package manager +- OpenAI API key +- Brave Search API key (Get one at https://brave.com/search/api/) + +## Setup + +1. Install npx (Node Package eXecute): + First, make sure to install [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) + and then run: + ```bash + npm install -g npx + ``` + +2. Clone the repository: + ```bash + git clone https://github.com/spring-projects/spring-ai-examples.git + cd model-context-protocol/brave-starter + ``` + +3. Set up your API keys: + ```bash + export OPENAI_API_KEY='your-openai-api-key-here' + export BRAVE_API_KEY='your-brave-api-key-here' + ``` + +4. Build the application: + ```bash + ./mvnw clean install + ``` + +## Running the Application + +Run the application using Maven: +```bash +./mvnw spring-boot:run +``` + +The application will demonstrate the integration by asking a sample question about Spring AI and Model Context Protocol, utilizing Brave Search to gather information. + +## How it Works + +The application demonstrates Spring AI integration with Brave Search through the Model Context Protocol (MCP). Here's an overview of the key components: + +### Project Configuration + +The project uses Spring AI's MCP boot starter: + +```xml + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + +``` + +The application configuration is defined in two files: + +1. `application.properties` - Core application settings: +```properties +# Application configuration +spring.application.name=mcp +spring.main.web-application-type=none + +# API Keys +spring.ai.openai.api-key=${OPENAI_API_KEY} + + +# MCP Configuration +spring.ai.mcp.client.stdio.enabled=true +spring.ai.mcp.client.stdio.servers-configuration=classpath:/mcp-servers-config.json +``` + +2. `mcp-servers-config.json` - MCP server configuration: +```json +{ + "mcpServers": { + "brave-search": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-brave-search" + ], + "env": { + } + } + } +} +``` + +### Auto-Configuration + +Spring Boot's auto-configuration handles the setup: +- Configures the application as a command-line tool (non-web) +- Sets up the OpenAI integration using the provided API key +- Enables the MCP STDIO client for communication with the Brave Search server +- Provides a `List` bean containing the Brave Search capabilities, which is automatically injected into the `CommandLineRunner` + +### Main Application + +The `Application.java` file demonstrates a simple Spring Boot application that: + +1. Uses Spring Boot's `CommandLineRunner` to execute a predefined question when the application starts +2. Creates a `ChatClient` with the automatically configured MCP tools (Brave Search capabilities) +3. Asks a specific question about Spring AI and Model Context Protocol +4. Prints both the question and the AI assistant's response to the console +5. Automatically closes the application after receiving the response + +Here's the key code from `Application.java`: + +```java +@Bean +public CommandLineRunner predefinedQuestions(ChatClient.Builder chatClientBuilder, + List tools, ConfigurableApplicationContext context) { + return args -> { + var chatClient = chatClientBuilder + .defaultTools(tools) + .build(); + + String question = "Does Spring AI support the Model Context Protocol? " + + "Please provide some references."; + + System.out.println("QUESTION: " + question); + System.out.println("ASSISTANT: " + chatClient.prompt(question).call().content()); + + context.close(); + }; +} +``` + +The application automatically: +- Injects the `ChatClient.Builder` and `ToolCallback` list (containing Brave Search capabilities) +- Configures the chat client with the available tools +- Executes a predefined question +- Uses Brave Search when needed to gather information for the response + +This setup allows the AI model to do the following: +- Understand when to use Brave Search +- Format queries appropriately +- Process and incorporate search results into responses diff --git a/model-context-protocol/brave-starter/mvnw b/model-context-protocol/brave-starter/mvnw new file mode 100755 index 0000000..eb65ff2 --- /dev/null +++ b/model-context-protocol/brave-starter/mvnw @@ -0,0 +1,305 @@ +#!/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. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Maven2 Start Up Batch script +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# M2_HOME - location of maven2's installed home dir +# MAVEN_OPTS - parameters passed to the Java VM when running Maven +# e.g. to debug Maven itself, use +# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +# MAVEN_SKIP_RC - flag to disable loading of mavenrc files +# ---------------------------------------------------------------------------- + +if [ -z "$MAVEN_SKIP_RC" ] ; then + + if [ -f /etc/mavenrc ] ; then + . /etc/mavenrc + fi + + if [ -f "$HOME/.mavenrc" ] ; then + . "$HOME/.mavenrc" + fi + +fi + +# OS specific support. $var _must_ be set to either true or false. +cygwin=false; +darwin=false; +mingw=false +case "`uname`" in + CYGWIN*) cygwin=true ;; + MINGW*) mingw=true;; + Darwin*) darwin=true + # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home + # See https://developer.apple.com/library/mac/qa/qa1170/_index.html + if [ -z "$JAVA_HOME" ]; then + if [ -x "/usr/libexec/java_home" ]; then + export JAVA_HOME="`/usr/libexec/java_home`" + else + export JAVA_HOME="/Library/Java/Home" + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=`java-config --jre-home` + fi +fi + +if [ -z "$M2_HOME" ] ; then + ## resolve links - $0 may be a link to maven's home + PRG="$0" + + # need this for relative symlinks + while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG="`dirname "$PRG"`/$link" + fi + done + + saveddir=`pwd` + + M2_HOME=`dirname "$PRG"`/.. + + # make it fully qualified + M2_HOME=`cd "$M2_HOME" && pwd` + + cd "$saveddir" + # echo Using m2 at $M2_HOME +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --unix "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --unix "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --unix "$CLASSPATH"` +fi + +# For Mingw, ensure paths are in UNIX format before anything is touched +if $mingw ; then + [ -n "$M2_HOME" ] && + M2_HOME="`(cd "$M2_HOME"; pwd)`" + [ -n "$JAVA_HOME" ] && + JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" +fi + +if [ -z "$JAVA_HOME" ]; then + javaExecutable="`which javac`" + if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then + # readlink(1) is not available as standard on Solaris 10. + readLink=`which readlink` + if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then + if $darwin ; then + javaHome="`dirname \"$javaExecutable\"`" + javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" + else + javaExecutable="`readlink -f \"$javaExecutable\"`" + fi + javaHome="`dirname \"$javaExecutable\"`" + javaHome=`expr "$javaHome" : '\(.*\)/bin'` + JAVA_HOME="$javaHome" + export JAVA_HOME + fi + fi +fi + +if [ -z "$JAVACMD" ] ; then + 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" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + else + JAVACMD="`which java`" + fi +fi + +if [ ! -x "$JAVACMD" ] ; then + echo "Error: JAVA_HOME is not defined correctly." >&2 + echo " We cannot execute $JAVACMD" >&2 + exit 1 +fi + +if [ -z "$JAVA_HOME" ] ; then + echo "Warning: JAVA_HOME environment variable is not set." +fi + +CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher + +# traverses directory structure from process work directory to filesystem root +# first directory with .mvn subdirectory is considered project base directory +find_maven_basedir() { + + if [ -z "$1" ] + then + echo "Path not specified to find_maven_basedir" + return 1 + fi + + basedir="$1" + wdir="$1" + while [ "$wdir" != '/' ] ; do + if [ -d "$wdir"/.mvn ] ; then + basedir=$wdir + break + fi + # workaround for JBEAP-8937 (on Solaris 10/Sparc) + if [ -d "${wdir}" ]; then + wdir=`cd "$wdir/.."; pwd` + fi + # end of workaround + done + echo "${basedir}" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + echo "$(tr -s '\n' ' ' < "$1")" + fi +} + +BASE_DIR=`find_maven_basedir "$(pwd)"` +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +########################################################################################## +# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +# This allows using the maven wrapper in projects that prohibit checking in binary data. +########################################################################################## +if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found .mvn/wrapper/maven-wrapper.jar" + fi +else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." + fi + if [ "$MVNW_REPOURL" = true]; then + jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + else + jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + fi + while IFS="=" read key value; do + case "$key" in (wrapperUrl) jarUrl="$value"; break ;; + esac + done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Downloading from: $jarUrl" + fi + wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" + if $cygwin; then + wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` + fi + + if command -v wget > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found wget ... using wget" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget "$jarUrl" -O "$wrapperJarPath" + else + wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" + fi + elif command -v curl > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found curl ... using curl" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl -o "$wrapperJarPath" "$jarUrl" -f + else + curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f + fi + + else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Falling back to using Java to download" + fi + javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaClass=`cygpath --path --windows "$javaClass"` + fi + if [ -e "$javaClass" ]; then + if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Compiling MavenWrapperDownloader.java ..." + fi + # Compiling the Java class + ("$JAVA_HOME/bin/javac" "$javaClass") + fi + if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + # Running the downloader + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Running MavenWrapperDownloader.java ..." + fi + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} +if [ "$MVNW_VERBOSE" = true ]; then + echo $MAVEN_PROJECTBASEDIR +fi +MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" + +# For Cygwin, switch paths to Windows format before running java +if $cygwin; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --path --windows "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --windows "$CLASSPATH"` + [ -n "$MAVEN_PROJECTBASEDIR" ] && + MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` +fi + +WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +exec "$JAVACMD" \ + $MAVEN_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/model-context-protocol/brave-starter/mvnw.cmd b/model-context-protocol/brave-starter/mvnw.cmd new file mode 100755 index 0000000..4f5150a --- /dev/null +++ b/model-context-protocol/brave-starter/mvnw.cmd @@ -0,0 +1,172 @@ +@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 Maven2 Start Up Batch script +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM M2_HOME - location of maven2's installed home dir +@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands +@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a key stroke before ending +@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven +@REM e.g. to debug Maven itself, use +@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files +@REM ---------------------------------------------------------------------------- + +@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' +@echo off +@REM set title of command window +title %0 +@REM enable echoing my setting MAVEN_BATCH_ECHO to 'on' +@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% + +@REM set %HOME% to equivalent of $HOME +if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") + +@REM Execute a user defined script before this one +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre +@REM check for pre script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" +if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" +:skipRcPre + +@setlocal + +set ERROR_CODE=0 + +@REM To isolate internal variables from possible post scripts, we use another setlocal +@setlocal + +@REM ==== START VALIDATION ==== +if not "%JAVA_HOME%" == "" goto OkJHome + +echo. +echo Error: JAVA_HOME not found in your environment. >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +:OkJHome +if exist "%JAVA_HOME%\bin\java.exe" goto init + +echo. +echo Error: JAVA_HOME is set to an invalid directory. >&2 +echo JAVA_HOME = "%JAVA_HOME%" >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +@REM ==== END VALIDATION ==== + +:init + +@REM Find the project base dir, i.e. the directory that contains the folder ".mvn". +@REM Fallback to current working directory if not found. + +set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% +IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir + +set EXEC_DIR=%CD% +set WDIR=%EXEC_DIR% +:findBaseDir +IF EXIST "%WDIR%"\.mvn goto baseDirFound +cd .. +IF "%WDIR%"=="%CD%" goto baseDirNotFound +set WDIR=%CD% +goto findBaseDir + +:baseDirFound +set MAVEN_PROJECTBASEDIR=%WDIR% +cd "%EXEC_DIR%" +goto endDetectBaseDir + +:baseDirNotFound +set MAVEN_PROJECTBASEDIR=%EXEC_DIR% +cd "%EXEC_DIR%" + +:endDetectBaseDir + +IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig + +@setlocal EnableExtensions EnableDelayedExpansion +for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a +@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% + +:endReadAdditionalConfig + +SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" +set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" +set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + +FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B +) + +@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +@REM This allows using the maven wrapper in projects that prohibit checking in binary data. +if exist %WRAPPER_JAR% ( + echo Found %WRAPPER_JAR% +) else ( + if not "%MVNW_REPOURL%" == "" ( + SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.2/maven-wrapper-0.5.2.jar" + ) + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %DOWNLOAD_URL% + + powershell -Command "&{"^ + "$webclient = new-object System.Net.WebClient;"^ + "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ + "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ + "}"^ + "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ + "}" + echo Finished downloading %WRAPPER_JAR% +) +@REM End of extension + +%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* +if ERRORLEVEL 1 goto error +goto end + +:error +set ERROR_CODE=1 + +:end +@endlocal & set ERROR_CODE=%ERROR_CODE% + +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost +@REM check for post script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" +if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" +:skipRcPost + +@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' +if "%MAVEN_BATCH_PAUSE%" == "on" pause + +if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% + +exit /B %ERROR_CODE% diff --git a/model-context-protocol/brave-starter/pom.xml b/model-context-protocol/brave-starter/pom.xml new file mode 100644 index 0000000..efd980b --- /dev/null +++ b/model-context-protocol/brave-starter/pom.xml @@ -0,0 +1,96 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.3.6 + + + com.example + ai-mcp-brave-starter + 0.0.1-SNAPSHOT + Spring AI - Model Context Protocol - Brave + Simple AI Application using MCP client to use Brave for Internet search + + 17 + + + + + + org.springframework.ai + spring-ai-bom + 1.0.0-SNAPSHOT + pom + import + + + + + + + org.springframework.boot + spring-boot-starter + + + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + + org.springframework.ai + spring-ai-openai-spring-boot-starter + + + + org.springframework.ai + spring-ai-mcp + + + + + + + + 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/libs-milestone-local + + false + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + + \ No newline at end of file diff --git a/model-context-protocol/brave-starter/spring-ai-mcp-brave.jpg b/model-context-protocol/brave-starter/spring-ai-mcp-brave.jpg new file mode 100644 index 0000000000000000000000000000000000000000..27fdc4b8452f699bfdb945b5f4cd4ff55b4826d9 GIT binary patch literal 255575 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

)T^$I;7tRMc%!6>^cUU< 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%0D}F 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 Z=U|{KMOpas-_H#H%;|4yfkVFx|1XX{-Y@_F literal 0 HcmV?d00001 diff --git a/model-context-protocol/brave-starter/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java b/model-context-protocol/brave-starter/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java new file mode 100644 index 0000000..302cf19 --- /dev/null +++ b/model-context-protocol/brave-starter/src/main/java/org/springframework/ai/mcp/samples/brave/Application.java @@ -0,0 +1,38 @@ +package org.springframework.ai.mcp.samples.brave; + +import java.util.List; + +import org.springframework.ai.chat.client.ChatClient; +import org.springframework.ai.tool.ToolCallback; +import org.springframework.boot.CommandLineRunner; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.context.annotation.Bean; + +@SpringBootApplication +public class Application { + + public static void main(String[] args) { + SpringApplication.run(Application.class, args); + } + + @Bean + public CommandLineRunner predefinedQuestions(ChatClient.Builder chatClientBuilder, List tools, + ConfigurableApplicationContext context) { + + return args -> { + + var chatClient = chatClientBuilder + .defaultTools(tools) + .build(); + + String question = "Does Spring AI support the Model Context Protocol? Please provide some references."; + + System.out.println("QUESTION: " + question); + System.out.println("ASSISTANT: " + chatClient.prompt(question).call().content()); + + context.close(); + }; + } +} \ No newline at end of file diff --git a/model-context-protocol/brave-starter/src/main/resources/application.properties b/model-context-protocol/brave-starter/src/main/resources/application.properties new file mode 100644 index 0000000..ecb878b --- /dev/null +++ b/model-context-protocol/brave-starter/src/main/resources/application.properties @@ -0,0 +1,8 @@ +spring.application.name=mcp +spring.main.web-application-type=none + +spring.ai.openai.api-key=${OPENAI_API_KEY} +spring.ai.anthropic.api-key=${ANTHROPIC_API_KEY} + +spring.ai.mcp.client.stdio.enabled=true +spring.ai.mcp.client.stdio.servers-configuration=classpath:/mcp-servers-config.json \ No newline at end of file diff --git a/model-context-protocol/brave-starter/src/main/resources/mcp-servers-config.json b/model-context-protocol/brave-starter/src/main/resources/mcp-servers-config.json new file mode 100644 index 0000000..df98809 --- /dev/null +++ b/model-context-protocol/brave-starter/src/main/resources/mcp-servers-config.json @@ -0,0 +1,13 @@ +{ + "mcpServers": { + "brave-search": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-brave-search" + ], + "env": { + } + } + } +} \ No newline at end of file diff --git a/model-context-protocol/mcp-weather-server-quickstart/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/mcp-weather-server-quickstart/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..d58dfb7 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,19 @@ +# 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/mcp-weather-server-quickstart/README.md b/model-context-protocol/mcp-weather-server-quickstart/README.md new file mode 100644 index 0000000..1691961 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/README.md @@ -0,0 +1,176 @@ +# Spring AI MCP Quick Weather Server Sample + +This sample project demonstrates a simplified implementation of the Spring AI Model Context Protocol (MCP). It shows how to create an MCP server that exposes weather-related tools using the National Weather Service API. + +## Overview + +The sample provides: +- A Spring Boot application implementing an MCP server +- Two transport mode implementations: Stdio and SSE (Server-Sent Events) +- Two weather-related tools: + - Get weather forecast by location (latitude/longitude) + - Get weather alerts by US state + +## 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 -Dspring.ai.mcp.server.transport=STDIO -Dspring.main.web-application-type=none -Dlogging.pattern.console= -jar target/mcp-weather-server-quick-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 -Dspring.ai.mcp.server.transport=WEBFLUX -jar target/mcp-weather-server-quick-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("-Dspring.ai.mcp.server.transport=STDIO", "-Dspring.main.web-application-type=none", + "-Dlogging.pattern.console=", "-jar", + "model-context-protocol/mcp-weather-server-quick/target/mcp-weather-server-quick-0.0.1-SNAPSHOT.jar") + .build(); + +var transport = new StdioClientTransport(stdioParams); +var client = McpClient.sync(transport).build(); +``` + +### SSE Client (ClientSse.java) +```java +var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); +var client = McpClient.using(transport).sync(); +``` + +### Claud Destop + +```json +{ + "mcpServers": { + "spring-ai-mcp-weather": { + "command": "java", + "args": [ + "-Dspring.ai.mcp.server.transport=STDIO", + "-Dspring.main.web-application-type=none", + "-Dlogging.pattern.console=", + "-jar", + "/mcp-weather-server-quick-0.0.1-SNAPSHOT.jar" + ] + } + } +} +``` + +## Available Tools + +### Weather Forecast Tool +- Name: `getWeatherForecastByLocation` +- Description: Get weather forecast for a specific latitude/longitude +- Parameters: + - `latitude`: double - Latitude coordinate + - `longitude`: double - Longitude coordinate +- Example: +```java +CallToolResult forecastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", 47.6062, "longitude", -122.3321))); +``` + +### Weather Alerts Tool +- Name: `getAlerts` +- Description: Get weather alerts for a US state +- Parameters: + - `state`: String - Two-letter US state code (e.g. CA, NY) +- Example: +```java +CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", + Map.of("state", "NY"))); +``` + +## 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); + +// Get weather forecast for Seattle +CallToolResult weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); +System.out.println("Weather Forcast: " + weatherForcastResult); + +// Get weather alerts for New York +CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); +System.out.println("Alert Response = " + alertResult); + +// Close client +client.closeGracefully(); +``` + +## Server Implementation + +The server is implemented using Spring Boot and Spring AI's tool annotations: + +```java +@SpringBootApplication +public class McpServerApplication { + + public static void main(String[] args) { + SpringApplication.run(McpServerApplication.class, args); + } + + @Bean + public List weatherTools(WeatherService weatherService) { + return List.of(ToolCallbacks.from(weatherService)); + } +} +``` + +The `WeatherService` class provides the tool implementations using the `@Tool` annotation: + +```java +@Service +public class WeatherService { + @Tool(description = "Get weather forecast for a specific latitude/longitude") + public String getWeatherForecastByLocation(double latitude, double longitude) { + // Implementation using weather.gov API + } + + @Tool(description = "Get weather alerts for a US state. Input is Two-letter US state code (e.g. CA, NY)") + public String getAlerts(String state) { + // Implementation using weather.gov API + } +} +``` + +## Configuration + +The application can be configured through `application.properties`: + +- `spring.ai.mcp.server.transport`: Transport mode to use (STDIO/WEBFLUX) +- `server.port`: Server port for WEBFLUX mode (default: 8080) +- `spring.main.banner-mode`: Set to 'off' for STDIO mode +- `logging.pattern.console`: Clear this property for STDIO mode +- `logging.file.name`: Path to log file (useful when console logging is disabled) diff --git a/model-context-protocol/mcp-weather-server-quickstart/mvnw b/model-context-protocol/mcp-weather-server-quickstart/mvnw new file mode 100755 index 0000000..19529dd --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/mvnw @@ -0,0 +1,259 @@ +#!/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/mcp-weather-server-quickstart/mvnw.cmd b/model-context-protocol/mcp-weather-server-quickstart/mvnw.cmd new file mode 100644 index 0000000..b150b91 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/mvnw.cmd @@ -0,0 +1,149 @@ +<# : 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/mcp-weather-server-quickstart/pom.xml b/model-context-protocol/mcp-weather-server-quickstart/pom.xml new file mode 100644 index 0000000..8637347 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/pom.xml @@ -0,0 +1,124 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.3.6 + + + + com.example + + mcp-weather-server-quickstart + 0.0.1-SNAPSHOT + + Spring AI MCP Weather Sample + Sample Spring Boot application demonstrating MCP client and server usage + + + 0.7.0-SNAPSHOT + + + + + + org.springframework.ai + spring-ai-bom + 1.0.0-SNAPSHOT + pom + import + + + + io.modelcontextprotocol.sdk + mcp-bom + ${mcp.version} + pom + import + + + + + + + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + + org.springframework + spring-web + + + + org.springframework.boot + spring-boot-starter + + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + repackage + + + + + + io.spring.javaformat + spring-javaformat-maven-plugin + 0.0.43 + + + validate + true + + validate + + + + + + + + + + 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/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java new file mode 100644 index 0000000..cbb92d6 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java @@ -0,0 +1,64 @@ +/* +* 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 java.util.Map; + +import io.modelcontextprotocol.client.McpClient; +import io.modelcontextprotocol.client.transport.ServerParameters; +import io.modelcontextprotocol.client.transport.StdioClientTransport; +import io.modelcontextprotocol.spec.McpSchema.CallToolRequest; +import io.modelcontextprotocol.spec.McpSchema.CallToolResult; +import io.modelcontextprotocol.spec.McpSchema.ListToolsResult; + +/** + * 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("-jar", + "model-context-protocol/mcp-weather-server-quickstart/target/mcp-weather-server-quickstart-0.0.1-SNAPSHOT.jar") + .build(); + + var transport = new StdioClientTransport(stdioParams); + var client = McpClient.sync(transport).build(); + + client.initialize(); + + // List and demonstrate tools + ListToolsResult toolsList = client.listTools(); + System.out.println("Available Tools = " + toolsList); + + CallToolResult weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); + System.out.println("Weather Forcast: " + weatherForcastResult); + + CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); + System.out.println("Alert Response = " + alertResult); + + client.closeGracefully(); + } + +} diff --git a/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java new file mode 100644 index 0000000..774a2ac --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java @@ -0,0 +1,23 @@ +package org.springframework.ai.mcp.sample.server; + +import java.util.List; + +import org.springframework.ai.tool.ToolCallback; +import org.springframework.ai.tool.ToolCallbacks; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.context.annotation.Bean; + +@SpringBootApplication +public class McpServerApplication { + + public static void main(String[] args) { + SpringApplication.run(McpServerApplication.class, args); + } + + @Bean + public List weatherTools(WeatherService weatherService) { + return List.of(ToolCallbacks.from(weatherService)); + } + +} diff --git a/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java new file mode 100644 index 0000000..5966ea1 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java @@ -0,0 +1,145 @@ +/* +* 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 java.util.stream.Collectors; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; + +import org.springframework.ai.tool.annotation.Tool; +import org.springframework.stereotype.Service; +import org.springframework.web.client.RestClient; +import org.springframework.web.client.RestClientException; + +@Service +public class WeatherService { + + private static final String BASE_URL = "https://api.weather.gov"; + + private final RestClient restClient; + + public WeatherService() { + + this.restClient = RestClient.builder() + .baseUrl(BASE_URL) + .defaultHeader("Accept", "application/geo+json") + .defaultHeader("User-Agent", "WeatherApiClient/1.0 (your@email.com)") + .build(); + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Points(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("forecast") String forecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Forecast(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("periods") List periods) { + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Period(@JsonProperty("number") Integer number, @JsonProperty("name") String name, + @JsonProperty("startTime") String startTime, @JsonProperty("endTime") String endTime, + @JsonProperty("isDaytime") Boolean isDayTime, @JsonProperty("temperature") Integer temperature, + @JsonProperty("temperatureUnit") String temperatureUnit, + @JsonProperty("temperatureTrend") String temperatureTrend, + @JsonProperty("probabilityOfPrecipitation") Map probabilityOfPrecipitation, + @JsonProperty("windSpeed") String windSpeed, @JsonProperty("windDirection") String windDirection, + @JsonProperty("icon") String icon, @JsonProperty("shortForecast") String shortForecast, + @JsonProperty("detailedForecast") String detailedForecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Alert(@JsonProperty("features") List features) { + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Feature(@JsonProperty("properties") Properties properties) { + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Properties(@JsonProperty("event") String event, @JsonProperty("areaDesc") String areaDesc, + @JsonProperty("severity") String severity, @JsonProperty("description") String description, + @JsonProperty("instruction") String instruction) { + } + } + + /** + * Get forecast for a specific latitude/longitude + * @param latitude Latitude + * @param longitude Longitude + * @return The forecast for the given location + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather forecast for a specific latitude/longitude") + public String getWeatherForecastByLocation(double latitude, double longitude) { + + var points = restClient.get() + .uri("/points/{latitude},{longitude}", latitude, longitude) + .retrieve() + .body(Points.class); + + var forecast = restClient.get().uri(points.properties().forecast()).retrieve().body(Forecast.class); + + String forecastText = forecast.properties().periods().stream().map(p -> { + return String.format(""" + %s: + Temperature: %s %s + Wind: %s %s + Forecast: %s + """, p.name(), p.temperature(), p.temperatureUnit(), p.windSpeed(), p.windDirection(), + p.detailedForecast()); + }).collect(Collectors.joining()); + + return forecastText; + } + + /** + * Get alerts for a specific area + * @param state Area code. Two-letter US state code (e.g. CA, NY) + * @return Human readable alert information + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather alerts for a US state. Input is Two-letter US state code (e.g. CA, NY)") + public String getAlerts(String state) { + Alert alert = restClient.get().uri("/alerts/active/area/{state}", state).retrieve().body(Alert.class); + + return alert.features() + .stream() + .map(f -> String.format(""" + Event: %s + Area: %s + Severity: %s + Description: %s + Instructions: %s + """, f.properties().event(), f.properties.areaDesc(), f.properties.severity(), + f.properties.description(), f.properties.instruction())) + .collect(Collectors.joining("\n")); + } + + public static void main(String[] args) { + WeatherService client = new WeatherService(); + System.out.println(client.getWeatherForecastByLocation(47.6062, -122.3321)); + System.out.println(client.getAlerts("NY")); + } + +} \ No newline at end of file diff --git a/model-context-protocol/mcp-weather-server-quickstart/src/main/resources/application.properties b/model-context-protocol/mcp-weather-server-quickstart/src/main/resources/application.properties new file mode 100644 index 0000000..9a78228 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-quickstart/src/main/resources/application.properties @@ -0,0 +1,14 @@ +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= + +spring.ai.mcp.server.enabled=true + +spring.ai.mcp.server.name=my-weather-server +spring.ai.mcp.server.version=0.0.1 + +logging.file.name=./model-context-protocol/mcp-weather-server-quickstart/target/mcp.weather-quickstart.log + diff --git a/model-context-protocol/mcp-weather-server-starter/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/mcp-weather-server-starter/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..d58dfb7 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,19 @@ +# 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/mcp-weather-server-starter/README.md b/model-context-protocol/mcp-weather-server-starter/README.md new file mode 100644 index 0000000..9b91a92 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/README.md @@ -0,0 +1,175 @@ +# Spring AI MCP Quick Weather Server Sample + +This sample project demonstrates a simplified implementation of the Spring AI Model Context Protocol (MCP). It shows how to create an MCP server that exposes weather-related tools using the National Weather Service API. + +## Overview + +The sample provides: +- A Spring Boot application implementing an MCP server +- Two transport mode implementations: Stdio and SSE (Server-Sent Events) +- Two weather-related tools: + - Get weather forecast by location (latitude/longitude) + - Get weather alerts by US state + +## 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) + +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 -Dspring.ai.mcp.server.transport=WEBFLUX -jar target/mcp-weather-server-quick-0.0.1-SNAPSHOT.jar +``` + +## Sample Clients + +The project includes example clients for both transport modes: + +### Stdio Client (ClientStdio.java) + +**Note:** When running via command line, you may need to specify the full path to your Java executable since the shell environment (including `.bashrc`) might not be loaded. For example, instead of `"java"`, you might need to use the full path like `"/home/user/.sdkman/candidates/java/current/bin/java"`. You can find your Java path by running `which java` in your terminal. + +```java +var stdioParams = ServerParameters.builder("java") // You may need to use full path to Java executable + .args("-Dspring.ai.mcp.server.transport=STDIO", "-Dspring.main.web-application-type=none", + "-Dlogging.pattern.console=", "-jar", + "model-context-protocol/mcp-weather-server-quick/target/mcp-weather-server-quick-0.0.1-SNAPSHOT.jar") + .build(); + +var transport = new StdioClientTransport(stdioParams); +var client = McpClient.sync(transport).build(); +``` + +### SSE Client (ClientSse.java) +```java +var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080")); +var client = McpClient.using(transport).sync(); +``` + +### Claude Desktop + +```json +{ + "mcpServers": { + "spring-ai-mcp-weather": { + "command": "java", + "args": [ + "-Dspring.ai.mcp.server.transport=STDIO", + "-Dspring.main.web-application-type=none", + "-Dlogging.pattern.console=", + "-jar", + "/mcp-weather-server-quick-0.0.1-SNAPSHOT.jar" + ] + } + } +} +``` + +## Available Tools + +### Weather Forecast Tool +- Name: `getWeatherForecastByLocation` +- Description: Get weather forecast for a specific latitude/longitude +- Parameters: + - `latitude`: double - Latitude coordinate + - `longitude`: double - Longitude coordinate +- Example: +```java +CallToolResult forecastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", 47.6062, "longitude", -122.3321))); +``` + +### Weather Alerts Tool +- Name: `getAlerts` +- Description: Get weather alerts for a US state +- Parameters: + - `state`: String - Two-letter US state code (e.g. CA, NY) +- Example: +```java +CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", + Map.of("state", "NY"))); +``` + +## Client Usage Example (SampleClient.java) + +```java +// Initialize client +client.initialize(); + +// Test connection +client.ping(); + +// List available tools +ListToolsResult tools = client.listTools(); +System.out.println("Available tools: " + tools); + +// Get weather forecast for Seattle +CallToolResult weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); +System.out.println("Weather Forcast: " + weatherForcastResult); + +// Get weather alerts for New York +CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); +System.out.println("Alert Response = " + alertResult); + +// Close client +client.closeGracefully(); +``` + +## Server Implementation + +The server is implemented using Spring Boot and Spring AI's tool annotations: + +```java +@SpringBootApplication +public class McpServerApplication { + + public static void main(String[] args) { + SpringApplication.run(McpServerApplication.class, args); + } + + @Bean + public List weatherTools(WeatherService weatherService) { + return List.of(ToolCallbacks.from(weatherService)); + } +} +``` + +The `WeatherService` class provides the tool implementations using the `@Tool` annotation: + +```java +@Service +public class WeatherService { + @Tool(description = "Get weather forecast for a specific latitude/longitude") + public String getWeatherForecastByLocation(double latitude, double longitude) { + // Implementation using weather.gov API + } + + @Tool(description = "Get weather alerts for a US state. Input is Two-letter US state code (e.g. CA, NY)") + public String getAlerts(String state) { + // Implementation using weather.gov API + } +} +``` + +## Configuration + +The application can be configured through `application.properties`: + +- `spring.ai.mcp.server.transport`: Transport mode to use (STDIO/WEBFLUX) +- `server.port`: Server port for WEBFLUX mode (default: 8080) +- `spring.main.banner-mode`: Set to 'off' for STDIO mode +- `logging.pattern.console`: Clear this property for STDIO mode +- `logging.file.name`: Path to log file (useful when console logging is disabled) diff --git a/model-context-protocol/mcp-weather-server-starter/mvnw b/model-context-protocol/mcp-weather-server-starter/mvnw new file mode 100755 index 0000000..19529dd --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/mvnw @@ -0,0 +1,259 @@ +#!/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/mcp-weather-server-starter/mvnw.cmd b/model-context-protocol/mcp-weather-server-starter/mvnw.cmd new file mode 100644 index 0000000..b150b91 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/mvnw.cmd @@ -0,0 +1,149 @@ +<# : 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/mcp-weather-server-starter/pom.xml b/model-context-protocol/mcp-weather-server-starter/pom.xml new file mode 100644 index 0000000..d37b3cf --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/pom.xml @@ -0,0 +1,133 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.3.6 + + + + com.example + + mcp-weather-server-starter + 0.0.1-SNAPSHOT + + Spring AI MCP Weather Sample + Sample Spring Boot application demonstrating MCP client and server usage + + + 0.7.0-SNAPSHOT + + + + + + org.springframework.ai + spring-ai-bom + 1.0.0-SNAPSHOT + pom + import + + + + io.modelcontextprotocol.sdk + mcp-bom + ${mcp.version} + pom + import + + + + + + + org.springframework.ai + spring-ai-core + + + + io.modelcontextprotocol.sdk + mcp-spring-webflux + + + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + + 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 + + + + + + + + + + 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/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java new file mode 100644 index 0000000..836dc41 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java @@ -0,0 +1,33 @@ +/* +* 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 ClientSse { + + 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/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java new file mode 100644 index 0000000..6374cab --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java @@ -0,0 +1,48 @@ +/* +* 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 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) { + + System.out.println(new File(".").getAbsolutePath()); + + var stdioParams = ServerParameters.builder("java") + .args("-Dspring.ai.mcp.server.transport=STDIO", "-Dspring.main.web-application-type=none", + "-Dlogging.pattern.console=", "-jar", + "model-context-protocol/mcp-weather-server-starter/target/mcp-weather-server-starter-0.0.1-SNAPSHOT.jar") + .build(); + + var transport = new StdioClientTransport(stdioParams); + + new SampleClient(transport).run(); + } + +} diff --git a/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java new file mode 100644 index 0000000..518658d --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java @@ -0,0 +1,61 @@ +/* +* 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.ListToolsResult; + +/** + * @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 weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); + System.out.println("Weather Forcast: " + weatherForcastResult); + + CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); + System.out.println("Alert Response = " + alertResult); + + client.closeGracefully(); + + } + +} diff --git a/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java new file mode 100644 index 0000000..774a2ac --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java @@ -0,0 +1,23 @@ +package org.springframework.ai.mcp.sample.server; + +import java.util.List; + +import org.springframework.ai.tool.ToolCallback; +import org.springframework.ai.tool.ToolCallbacks; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.context.annotation.Bean; + +@SpringBootApplication +public class McpServerApplication { + + public static void main(String[] args) { + SpringApplication.run(McpServerApplication.class, args); + } + + @Bean + public List weatherTools(WeatherService weatherService) { + return List.of(ToolCallbacks.from(weatherService)); + } + +} diff --git a/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java new file mode 100644 index 0000000..5966ea1 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/WeatherService.java @@ -0,0 +1,145 @@ +/* +* 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 java.util.stream.Collectors; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; + +import org.springframework.ai.tool.annotation.Tool; +import org.springframework.stereotype.Service; +import org.springframework.web.client.RestClient; +import org.springframework.web.client.RestClientException; + +@Service +public class WeatherService { + + private static final String BASE_URL = "https://api.weather.gov"; + + private final RestClient restClient; + + public WeatherService() { + + this.restClient = RestClient.builder() + .baseUrl(BASE_URL) + .defaultHeader("Accept", "application/geo+json") + .defaultHeader("User-Agent", "WeatherApiClient/1.0 (your@email.com)") + .build(); + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Points(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("forecast") String forecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Forecast(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("periods") List periods) { + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Period(@JsonProperty("number") Integer number, @JsonProperty("name") String name, + @JsonProperty("startTime") String startTime, @JsonProperty("endTime") String endTime, + @JsonProperty("isDaytime") Boolean isDayTime, @JsonProperty("temperature") Integer temperature, + @JsonProperty("temperatureUnit") String temperatureUnit, + @JsonProperty("temperatureTrend") String temperatureTrend, + @JsonProperty("probabilityOfPrecipitation") Map probabilityOfPrecipitation, + @JsonProperty("windSpeed") String windSpeed, @JsonProperty("windDirection") String windDirection, + @JsonProperty("icon") String icon, @JsonProperty("shortForecast") String shortForecast, + @JsonProperty("detailedForecast") String detailedForecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Alert(@JsonProperty("features") List features) { + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Feature(@JsonProperty("properties") Properties properties) { + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Properties(@JsonProperty("event") String event, @JsonProperty("areaDesc") String areaDesc, + @JsonProperty("severity") String severity, @JsonProperty("description") String description, + @JsonProperty("instruction") String instruction) { + } + } + + /** + * Get forecast for a specific latitude/longitude + * @param latitude Latitude + * @param longitude Longitude + * @return The forecast for the given location + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather forecast for a specific latitude/longitude") + public String getWeatherForecastByLocation(double latitude, double longitude) { + + var points = restClient.get() + .uri("/points/{latitude},{longitude}", latitude, longitude) + .retrieve() + .body(Points.class); + + var forecast = restClient.get().uri(points.properties().forecast()).retrieve().body(Forecast.class); + + String forecastText = forecast.properties().periods().stream().map(p -> { + return String.format(""" + %s: + Temperature: %s %s + Wind: %s %s + Forecast: %s + """, p.name(), p.temperature(), p.temperatureUnit(), p.windSpeed(), p.windDirection(), + p.detailedForecast()); + }).collect(Collectors.joining()); + + return forecastText; + } + + /** + * Get alerts for a specific area + * @param state Area code. Two-letter US state code (e.g. CA, NY) + * @return Human readable alert information + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather alerts for a US state. Input is Two-letter US state code (e.g. CA, NY)") + public String getAlerts(String state) { + Alert alert = restClient.get().uri("/alerts/active/area/{state}", state).retrieve().body(Alert.class); + + return alert.features() + .stream() + .map(f -> String.format(""" + Event: %s + Area: %s + Severity: %s + Description: %s + Instructions: %s + """, f.properties().event(), f.properties.areaDesc(), f.properties.severity(), + f.properties.description(), f.properties.instruction())) + .collect(Collectors.joining("\n")); + } + + public static void main(String[] args) { + WeatherService client = new WeatherService(); + System.out.println(client.getWeatherForecastByLocation(47.6062, -122.3321)); + System.out.println(client.getAlerts("NY")); + } + +} \ No newline at end of file diff --git a/model-context-protocol/mcp-weather-server-starter/src/main/resources/application.properties b/model-context-protocol/mcp-weather-server-starter/src/main/resources/application.properties new file mode 100644 index 0000000..f740026 --- /dev/null +++ b/model-context-protocol/mcp-weather-server-starter/src/main/resources/application.properties @@ -0,0 +1,16 @@ +# 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= + +spring.ai.mcp.server.enabled=true + +spring.ai.mcp.server.name=my-weather-server +spring.ai.mcp.server.version=0.0.1 + +spring.ai.mcp.server.transport=WEBFLUX + +logging.file.name=./model-context-protocol/mcp-weather-server-starter/target/mcp.weather-starter.log + diff --git a/model-context-protocol/mcp-weather-server/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/mcp-weather-server/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..d58dfb7 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,19 @@ +# 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/mcp-weather-server/README.md b/model-context-protocol/mcp-weather-server/README.md new file mode 100644 index 0000000..0d4688c --- /dev/null +++ b/model-context-protocol/mcp-weather-server/README.md @@ -0,0 +1,143 @@ +# Spring AI MCP Sample Weather MCP Server + +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-weather-server/target/mcp-weather-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-weather-server/target/mcp-weather-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", "-Dspring.main.web-application-type=none", "-jar", + "model-context-protocol/mcp-weather-server/target/mcp-weather-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: `getWeatherForecastByLocation` +- Description: Weather forecast tool by location +- Parameters: + - `lat, long`: String - latitude, longitude of the locaiton +- Example: +```java +CallToolResult weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); +``` + + +## 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); + +CallToolResult weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); +System.out.println("Weather Forcast: " + weatherForcastResult); + +CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); +System.out.println("Alert Response = " + alertResult); + + +// Close client +client.closeGracefully(); +``` + +## Server Usage Example + +```java +@Configuration +public class CustomMcpServerConfig { + + @Bean + public WeatherApiClient weatherApiClient() { + return new WeatherApiClient(); + } + + @Bean + public McpSyncServer mcpServer(ServerMcpTransport transport, WeatherApiClient weatherApiClient) { // @formatter:off + + // Configure server capabilities with resource support + var capabilities = McpSchema.ServerCapabilities.builder() + .tools(true) // Tool 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 Weather Server", "1.0.0") + .capabilities(capabilities) + .tools(ToolHelper.toSyncToolRegistration(ToolCallbacks.from(weatherApiClient))) // Add @Tools + .build(); + + return server; // @formatter:on + } // @formatter:on +} +``` + +## 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 + diff --git a/model-context-protocol/mcp-weather-server/mvnw b/model-context-protocol/mcp-weather-server/mvnw new file mode 100755 index 0000000..19529dd --- /dev/null +++ b/model-context-protocol/mcp-weather-server/mvnw @@ -0,0 +1,259 @@ +#!/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/mcp-weather-server/mvnw.cmd b/model-context-protocol/mcp-weather-server/mvnw.cmd new file mode 100644 index 0000000..b150b91 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/mvnw.cmd @@ -0,0 +1,149 @@ +<# : 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/mcp-weather-server/pom.xml b/model-context-protocol/mcp-weather-server/pom.xml new file mode 100644 index 0000000..8101dab --- /dev/null +++ b/model-context-protocol/mcp-weather-server/pom.xml @@ -0,0 +1,123 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.3.6 + + + + com.example + + mcp-weather-server + 0.0.1-SNAPSHOT + + Spring AI MCP Weather Sample + Sample Spring Boot application demonstrating MCP client and server usage + + + 0.7.0-SNAPSHOT + + + + + + org.springframework.ai + spring-ai-bom + 1.0.0-SNAPSHOT + pom + import + + + + io.modelcontextprotocol.sdk + mcp-bom + ${mcp.version} + pom + import + + + + + + + org.springframework.ai + spring-ai-core + + + + org.springframework.ai + spring-ai-mcp + + + + io.modelcontextprotocol.sdk + mcp-spring-webflux + + + + + 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/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java new file mode 100644 index 0000000..836dc41 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientSse.java @@ -0,0 +1,33 @@ +/* +* 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 ClientSse { + + 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/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java new file mode 100644 index 0000000..3a0fa45 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java @@ -0,0 +1,43 @@ +/* +* 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 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) { + + 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-weather-server/target/mcp-weather-server-0.0.1-SNAPSHOT.jar") + .build(); + + var transport = new StdioClientTransport(stdioParams); + + new SampleClient(transport).run(); + } + +} diff --git a/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java new file mode 100644 index 0000000..518658d --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java @@ -0,0 +1,61 @@ +/* +* 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.ListToolsResult; + +/** + * @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 weatherForcastResult = client.callTool(new CallToolRequest("getWeatherForecastByLocation", + Map.of("latitude", "47.6062", "longitude", "-122.3321"))); + System.out.println("Weather Forcast: " + weatherForcastResult); + + CallToolResult alertResult = client.callTool(new CallToolRequest("getAlerts", Map.of("state", "NY"))); + System.out.println("Alert Response = " + alertResult); + + client.closeGracefully(); + + } + +} diff --git a/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java new file mode 100644 index 0000000..586f8d8 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java @@ -0,0 +1,13 @@ +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/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java new file mode 100644 index 0000000..5177182 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerConfig.java @@ -0,0 +1,67 @@ +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.spec.McpSchema; +import io.modelcontextprotocol.spec.ServerMcpTransport; + +import org.springframework.ai.mcp.McpToolUtils; +import org.springframework.ai.tool.ToolCallbacks; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.web.reactive.function.server.RouterFunction; + +@Configuration +public class McpServerConfig { + + // 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(); + } + + @Bean + public WeatherApiClient weatherApiClient() { + return new WeatherApiClient(); + } + + @Bean + public McpSyncServer mcpServer(ServerMcpTransport transport, WeatherApiClient weatherApiClient) { // @formatter:off + + // Configure server capabilities with resource support + var capabilities = McpSchema.ServerCapabilities.builder() + .tools(true) // Tool 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 Weather Server", "1.0.0") + .capabilities(capabilities) + .tools(McpToolUtils.toSyncToolRegistration(ToolCallbacks.from(weatherApiClient))) // Add @Tools + .build(); + + return server; // @formatter:on + } // @formatter:on + +} diff --git a/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/WeatherApiClient.java b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/WeatherApiClient.java new file mode 100644 index 0000000..171456f --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/java/org/springframework/ai/mcp/sample/server/WeatherApiClient.java @@ -0,0 +1,144 @@ +/* +* 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 java.util.stream.Collectors; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; + +import org.springframework.ai.tool.annotation.Tool; +import org.springframework.web.client.RestClient; +import org.springframework.web.client.RestClientException; + +public class WeatherApiClient { + + private static final String BASE_URL = "https://api.weather.gov"; + + private final RestClient restClient; + + public static void main(String[] args) { + WeatherApiClient client = new WeatherApiClient(); + System.out.println(client.getWeatherForecastByLocation(47.6062, -122.3321)); + System.out.println(client.getAlerts("NY")); + } + + public WeatherApiClient() { + + this.restClient = RestClient.builder() + .baseUrl(BASE_URL) + .defaultHeader("Accept", "application/geo+json") + .defaultHeader("User-Agent", "WeatherApiClient/1.0 (your@email.com)") + .build(); + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Points(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("forecast") String forecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Forecast(@JsonProperty("properties") Props properties) { + @JsonIgnoreProperties(ignoreUnknown = true) + public record Props(@JsonProperty("periods") List periods) { + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Period(@JsonProperty("number") Integer number, @JsonProperty("name") String name, + @JsonProperty("startTime") String startTime, @JsonProperty("endTime") String endTime, + @JsonProperty("isDaytime") Boolean isDayTime, @JsonProperty("temperature") Integer temperature, + @JsonProperty("temperatureUnit") String temperatureUnit, + @JsonProperty("temperatureTrend") String temperatureTrend, + @JsonProperty("probabilityOfPrecipitation") Map probabilityOfPrecipitation, + @JsonProperty("windSpeed") String windSpeed, @JsonProperty("windDirection") String windDirection, + @JsonProperty("icon") String icon, @JsonProperty("shortForecast") String shortForecast, + @JsonProperty("detailedForecast") String detailedForecast) { + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Alert(@JsonProperty("features") List features) { + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Feature(@JsonProperty("properties") Properties properties) { + + public String toText() { + return String.format(""" + Event: %s + Area: %s + Severity: %s + Description: %s + Instructions: %s + """, properties.event(), properties.areaDesc(), properties.severity(), properties.description(), + properties.instruction()); + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Properties(@JsonProperty("event") String event, @JsonProperty("areaDesc") String areaDesc, + @JsonProperty("severity") String severity, @JsonProperty("description") String description, + @JsonProperty("instruction") String instruction) { + } + } + + /** + * Get forecast for a specific latitude/longitude + * @param latitude Latitude + * @param longitude Longitude + * @return The forecast for the given location + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather forecast for a specific latitude/longitude") + public String getWeatherForecastByLocation(double latitude, double longitude) { + + var points = restClient.get() + .uri("/points/{latitude},{longitude}", latitude, longitude) + .retrieve() + .body(Points.class); + + var forecast = restClient.get().uri(points.properties().forecast()).retrieve().body(Forecast.class); + + String forecastText = forecast.properties().periods().stream().map(p -> { + return String.format(""" + %s: + Temperature: %s %s + Wind: %s %s + Forecast: %s + """, p.name(), p.temperature(), p.temperatureUnit(), p.windSpeed(), p.windDirection(), + p.detailedForecast()); + }).collect(Collectors.joining()); + + return forecastText; + } + + /** + * Get alerts for a specific area + * @param state Area code. Two-letter US state code (e.g. CA, NY) + * @return Human readable alert information + * @throws RestClientException if the request fails + */ + @Tool(description = "Get weather alerts for a US state. Input is Two-letter US state code (e.g. CA, NY)") + public String getAlerts(String state) { + Alert alert = restClient.get().uri("/alerts/active/area/{state}", state).retrieve().body(Alert.class); + + return alert.features().stream().map(f -> f.toText()).collect(Collectors.joining("\n")); + } + +} \ No newline at end of file diff --git a/model-context-protocol/mcp-weather-server/src/main/resources/application.properties b/model-context-protocol/mcp-weather-server/src/main/resources/application.properties new file mode 100644 index 0000000..718b295 --- /dev/null +++ b/model-context-protocol/mcp-weather-server/src/main/resources/application.properties @@ -0,0 +1,11 @@ +# 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.weather.log \ No newline at end of file diff --git a/model-context-protocol/mcp-webflux-server-starter/.mvn/wrapper/maven-wrapper.properties b/model-context-protocol/mcp-webflux-server-starter/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..d58dfb7 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,19 @@ +# 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/mcp-webflux-server-starter/README.md b/model-context-protocol/mcp-webflux-server-starter/README.md new file mode 100644 index 0000000..45ebb61 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/README.md @@ -0,0 +1,193 @@ +# 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 +java -jar target/mcp-webflux-server-starter-0.0.1-SNAPSHOT.jar +``` + +## 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 List tools(OpenLibrary openLibrary) { + List tools = new ArrayList<>(); + + // Add OpenLibrary tools + tools.addAll(List.of(ToolCallbacks.from(openLibrary))); + + // Add toUpperCase tool + tools.add(FunctionToolCallback + .builder("toUpperCase", + (Function) s -> s.input().toUpperCase()) + .description("To upper case") + .inputType(ToUpperCaseInput.class) + .build()); + + return tools; + } +} +``` + +### 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/mcp-webflux-server-starter/mvnw b/model-context-protocol/mcp-webflux-server-starter/mvnw new file mode 100755 index 0000000..19529dd --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/mvnw @@ -0,0 +1,259 @@ +#!/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/mcp-webflux-server-starter/mvnw.cmd b/model-context-protocol/mcp-webflux-server-starter/mvnw.cmd new file mode 100644 index 0000000..b150b91 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/mvnw.cmd @@ -0,0 +1,149 @@ +<# : 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/mcp-webflux-server-starter/pom.xml b/model-context-protocol/mcp-webflux-server-starter/pom.xml new file mode 100644 index 0000000..e055579 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/pom.xml @@ -0,0 +1,124 @@ + + + 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 + + + 0.7.0-SNAPSHOT + 1.0.0-SNAPSHOT + + + + + + org.springframework.ai + spring-ai-bom + ${sprign-ai.version} + pom + import + + + io.modelcontextprotocol.sdk + mcp-bom + ${mcp.version} + pom + import + + + + + + + + io.modelcontextprotocol.sdk + mcp-spring-webflux + + + + org.springframework.ai + spring-ai-mcp-spring-boot-starter + + + + org.springframework.boot + spring-boot-starter-webflux + + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + repackage + + + + + + io.spring.javaformat + spring-javaformat-maven-plugin + 0.0.43 + + + validate + true + + validate + + + + + + + + + + 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/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java new file mode 100644 index 0000000..43c1846 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientStdio.java @@ -0,0 +1,42 @@ +/* +* 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.transport=STDIO", "-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/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java new file mode 100644 index 0000000..46dfbff --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/ClientWebFluxSse.java @@ -0,0 +1,33 @@ +/* +* 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/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java new file mode 100644 index 0000000..9beb9a5 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/client/SampleClient.java @@ -0,0 +1,80 @@ +/* +* 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/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java new file mode 100644 index 0000000..84a0502 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java @@ -0,0 +1,117 @@ +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.ToolCallbacks; +import org.springframework.ai.tool.function.FunctionToolCallback; +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 List tools(OpenLibrary openLibrary) { + + List tools = new ArrayList<>(); + + tools.addAll(List.of(ToolCallbacks.from(openLibrary))); + + tools.add(FunctionToolCallback + .builder("toUpperCase", (Function) s -> s.input().toUpperCase()) + .description("To upper case") + .inputType(ToUpperCaseInput.class) + .build()); + + return tools; + } + + @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/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java new file mode 100644 index 0000000..04d3d93 --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/java/org/springframework/ai/mcp/sample/server/OpenLibrary.java @@ -0,0 +1,82 @@ +/* +* 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/mcp-webflux-server-starter/src/main/resources/application.properties b/model-context-protocol/mcp-webflux-server-starter/src/main/resources/application.properties new file mode 100644 index 0000000..751f64d --- /dev/null +++ b/model-context-protocol/mcp-webflux-server-starter/src/main/resources/application.properties @@ -0,0 +1,10 @@ +# 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.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 diff --git a/pom.xml b/pom.xml index 8e6de52..de36e88 100644 --- a/pom.xml +++ b/pom.xml @@ -25,9 +25,15 @@ model-context-protocol/sqlite/chatbot model-context-protocol/filesystem model-context-protocol/brave + model-context-protocol/brave-starter + model-context-protocol/brave-chatbot model-context-protocol/mcp-webmvc-server model-context-protocol/mcp-webflux-server + model-context-protocol/mcp-webflux-server-starter model-context-protocol/mcp-servlet-server + model-context-protocol/mcp-weather-server + model-context-protocol/mcp-weather-server-starter + model-context-protocol/mcp-weather-server-quickstart agentic-patterns