r behalf. ## Getting started Start with: * A Github [account](https://github.com/signup) * (Optional) An [API key](https://resos.com/support/how-to-use-resos-rest-api/) from ResOS * you only need one if you intend to register as a restaurateur! * we will spin up a [backend](backend) that is API-compatible, implemented with Spring Boot Starter Data JDBC * An LLM provider * e.g., Groq Cloud, OpenRouter, or OpenAI ## Prerequisites * Git CLI (2.43.0 or better) * Github CLI (2.65.0 or better) * httpie CLI (3.2.2 or better) * Java SDK (21 or better) * Maven (3.9.9 or better) * an LLM provider account (if using public cloud or commercially hosted models) ## How to clone with Git CLI ```bash git clone https://github.com/pacphi/spring-ai-resos ``` with Github CLI ```bash gh repo clone pacphi/spring-ai-resos ``` ## How to build Open a terminal shell, then execute: ```bash cd spring-ai-resos mvn clean install ``` ## How to consume If you want to incorporate any of the starters as dependencies in your own projects, you would: ### Add dependency Maven ```maven me.pacphi spring-ai-resos-client {release-version} ``` Gradle ```gradle implementation 'me.pacphi:spring-ai-resos-client:{release-version}' ``` > Replace occurrences of {release-version} above with a valid artifact release version number ### Add configuration Following Spring Boot conventions, you would add a stanza like this to your: application.properties ```properties default.url=${RESOS_API_ENDPOINT:https://api.resos.com/v1} ``` application.yml ```yaml default: url: ${RESOS_API_ENDPOINT:https://api.resos.com/v1} ``` > To activate the client, specify an API key (if required), and tune other associated configuration. Consult the [chatbot](mcp-client) module's configuration for alternative `dependencies` and `configuration` that are available to add. Configuration will be found in labeled `spring.config.activate.on-profile` sections of the [application.yml](mcp-client/src/main/resources/application.yml) file. ## How to run You're going to need to launch the [backend](backend) module first, unless you're a restaurateur, and you have a valid API key for interacting with the ResOS v1.2 API. To launch the backend, open a terminal shell and execute ```bash cd backend mvn clean spring-boot:run -Dspring-boot.run.profiles=dev -Dspring-boot.run.jvmArguments="--add-opens java.base/java.net=ALL-UNNAMED" ``` There's the [chatbot](mcp-client) module. But there's also a way to integrate with Claude desktop via MCP client configuration that will consume the [MCP server](mcp-server) implementation. ### with Claude Desktop Follow these instructions. Add the following stanza to a file called `claude_desktop_config.json`: ```json "spring-ai-resos": { "command": "java", "args": [ "-jar", "/target/spring-ai-resos-mcp-server-0.0.1-SNAPSHOT.jar" ] } ``` or for testing with backend ```json "spring-ai-resos": { "command": "java", "args": [ "-Dspring.profiles.active=dev", "-jar", "/target/spring-ai-resos-mcp-server-0.0.1-SNAPSHOT.jar" ] } ``` Restart Claude Desktop instance. Verify that you have a new set of tool calls available. Chat with Claude. ### with Chatbot Follow these instructions. To launch the [server](mcp-server) module, open a terminal shell and execute ```bash cd mcp-server export RESOS_API_ENDPOINT=http://localhost:8080/api/v1/resos mvn spring-boot:run -Dspring-boot.run.profiles=cloud,dev ``` Next, we'll store an API key in a credential file that will allow the chatbot to interact with an LLM service provider. ```bash cd ../mcp-client ``` #### leveraging OpenAI Build and run a version of the chatbot that is compatible for use with [OpenAI](https://openai.com). You will need to [obtain an API key](https://platform.openai.com/settings/profile?tab=api-keys). Before launching the app: * Create a `config` folder which would be a sibling of the `src` folder. Create a

Developing a Spring AI Enhanced Restaurant Booking System Employing an API-first Approach

Comments