About Spring AI Apps Project
Spring AI Apps Project is a set of Spring Boot examples for integrating AI with Spring AI. Its `spring-ai-mcp` example demonstrates MCP client and server applications exposing tools and prompts.
Key features
- 01Spring Boot AI integration examples
- 02MCP client and server example
- 03Exposes tools and prompts
- 04Runs with Spring Maven Plugin
Use cases
- 01Explore MCP integration in Spring AI
- 02Run AI-enabled Spring Boot examples
MCP support
The `spring-ai-mcp` example includes client-side and server-side applications that expose tools and prompts to other services.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESpring AI Apps Project 
This project demonstrates the integration of AI capabilities within a Spring Boot application, utilizing the Spring AI framework.
Table of Contents
Running the application
You can always run all the apps locally with Spring Maven Plugin support:
mvn spring-boot:run
Sometimes, you would have to connect the app with the AI model. It can be OpenAI or your preferred model. Before running the app you should export the API token as shown below.
export SPRING_AI_OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>
Architecture
MCP Client/Server
The example is available in the spring-ai-mcp directory. Here's the diagram that visualizes architecture.

Articles
- Getting started with the Spring AI MCP concept. Implement a client-side and a server-side application that exposes
@ToolsandPromptsto other services. The example is available in the branch master. A detailed guide may be found in the following article: Using Model Context Protocol (MCP) with Spring AI
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.