Carsmcpserver

🚀 Milestone Protocol (MCP) Car Server

This is an MCP (Model Context Protocol) server built on Spring AI. This project demonstrates how to use Spring AI's ToolCallback API to expose tools for handling the vehicle list in Amarpreet's wishlist.

🚀 Quick Start

Demo

Demo Video

Project Structure

The project is organized as follows:

• src/main/java/com/amarpreet/carsmcpserver/

  • CarsmcpserverApplication.java: The main entry point of the application. It initializes the application and registers the ToolCallback bean using the CarService class.
  • Car.java: A simple record class representing a car, with two fields: modelName and buildYear.
  • CarService.java: A service class that provides methods for interacting with the vehicle list. These methods are exposed as tools via the ToolCallback API.

• src/main/resources/application.properties: Contains the configuration properties for the Spring Boot application.

• src/test/java/com/amarpreet/carsmcpserver/

  • CarsmcpserverApplicationTests.java: Contains a basic test to ensure that the application context loads correctly.

ToolCallback API

The ToolCallback API is used to expose the methods in the CarService class as tools. These tools can be called programmatically or accessed through an AI-driven interface. In CarsmcpserverApplication.java:

@Bean
public List<ToolCallback> amarpreetTools(CarService carService) {
    return List.of(ToolCallbacks.from(carService));
}

This registers all methods marked as @Tool in the CarService class as ToolCallback instances.

CarService

The CarService class is the core of this project. It manages a vehicle list and provides the following methods:

Methods in CarService

getCars()

• Tool Name: get_cars
• Description: Get the vehicle list in Amarpreet's wishlist.
• Return Type: List<Car>

getCar(String name)

• Tool Name: get_car_by_name
• Description: Find a vehicle by model name.
• Parameters:
  • name - The model name to search for.
• Return Type: Car (returns null if not found)

getCarByYear(Integer year)

• Tool Name: get_car_by_years
• Description: Find a vehicle by manufacturing year.
• Parameters:
  • year - The year to search for.
• Return Type: Car (returns null if not found)

Initialization

In the CarService class, use the @PostConstruct annotation to initialize the vehicle list during application startup:

@PostConstruct
public void init() {
    log.info("Initializing cars MCP server...");
    cars.addAll(List.of(
        new Car("BMW Neue Klasse", 2025),
        new Car("Ferrari EV", 2025),
        new Car("Mercedes AMG 4dr EV", 2025),
        new Car("Porsche 718 Boxster", 2025)
    ));
}

Installation

Build the project using Maven:

mvn clean install

Run the application:

java -jar target/carsmcpserver-0.0.1-SNAPSHOT.jar

Configuration

This project can be configured through the application.properties file located in src/main/resources. Key properties include:

This project demonstrates how to use Spring AI's tool callback API to expose business logic to AI for interaction. The video demo should provide a more intuitive demonstration of how the features work.