vadymhrnk/spring-ai-mcp-server

MCP Server and Client to manage Books and Authors

Welcome to the repository! This project implements a Model Context Protocol (MCP) server and client for managing authors and books with GraphQL API.

Get Started

To run the MCP server and client with Docker, follow this instruction:

1. Clone the repository:

   git clone https://github.com/vadymhrnk/spring-ai-mcp-server.git
   

2. Download JDK 25, Apache Maven and Docker

3. Go to both folders:

   cd spring-ai-mcp-server/mcp-server
   cd spring-ai-mcp-server/mcp-client
   

4. Build *.jar files for the Docker:

   mvn package
   

5. Build and then run the project using Docker:

   docker compose build
   
   docker compose up
   

Technologies Used

MCP Server Technologies

• Java 25: primary programming language for backend development
• Spring Boot: framework for building Java applications
  • Spring AI MCP Server: MCP server implementation for Spring
  • Spring GraphQL: GraphQL support for Spring applications
  • Spring Data JPA: Java Persistence API for database operations
  • Spring Boot Actuator: application monitoring and management
• PostgreSQL: relational database for data storage
• Liquibase: database schema migration tool
• Lombok: reduces boilerplate code
• H2 Database: in-memory database for testing
• Docker: containerization platform

MCP Client Technologies

• Spring Boot: application framework
  • Spring Web: web application support
  • Spring AI MCP Client: MCP client implementation for Spring

Application Endpoints

The MCP server exposes a GraphQL endpoint at /graphql where you can interact with the application using the defined queries and mutations.