Content
# GIDS 2026 Spring AI MCP Demo
This is a Help Desk application that demonstrates how Spring AI enables
integration of Spring Boot business applications with AI capabilities.
## Modules
- Spring AI Demo
- Hotel Service (MCP Server)
- Help Desk (MCP Client)
## Test MCP Server using MCP Inspector
```shell
$ npx @modelcontextprotocol/inspector@latest
```
## Start MCP Server using STDIO protocol
```shell
$ cd hotel-service
$ mvn clean package
```
```shell
Transport Type: STDIO
Command: java
Arguments: -jar /Users/siva/Siva/Projects/My/gids-2026-spring-ai-mcp/hotel-service/target/hotel-service-0.0.1-SNAPSHOT.jar
```
### Using Docker to run an MCP server
Build docker image:
```shell
$ cd hotel-service
$ mvn spring-boot:build-image -DskipTests -Dspring-boot.build-image.imageName=sivaprasadreddy/hotel-service
```
```shell
Transport Type: STDIO
Command: docker
Arguments: run -i --rm sivaprasadreddy/hotel-service
```
## Start MCP Server using HTTP Streamable protocol
Update mcp server config in application.properties to use HTTP Streamable protocol
```shell
$ cd hotel-service
$ mvn spring-boot:run
```
```shell
Transport Type: Streamable HTTP
URL: http://localhost:8081/mcp
```
Refer `requests.http` file for sample data to test the MCP tools.
## Start the MCP Client application
```shell
$ cd help-desk
$ mvn spring-boot:run
```
Go to http://localhost:8080/
- Ask "Find hotels in Bangalore from 2nd May 2026 to 4th May 2026"
- Ask "Book {hotel name or id} for Siva and his email is siva@gmail.com"
- Ask "Give me the booking details for {booking_ref_number}"