里程牌协议（MCP）汽车服务器

这是一个基于Spring AI构建的MCP（模型上下文协议）服务器。该项目展示了如何使用Spring AI的ToolCallback API来公开工具，以处理Amarpreet心愿单中的车辆列表。

演示

演示视频

项目结构

项目组织如下：

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

  • CarsmcpserverApplication.java: 应用程序的主要入口点。它初始化应用程序并使用CarService类注册ToolCallback bean。
  • Car.java: 表示汽车的简单record类，具有两个字段：modelName和buildYear。
  • CarService.java: 提供与车辆列表交互的方法的服务类。这些方法通过ToolCallback API公开为工具。

• src/main/resources/application.properties: 包含Spring Boot应用程序的配置属性。

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

  • CarsmcpserverApplicationTests.java: 包含一个基本测试，确保应用上下文正确加载。

ToolCallback API

ToolCallback API用于将CarService类中的方法公开为工具。这些工具可以程序化调用或通过AI驱动的接口访问。在CarsmcpserverApplication.java中：

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

这会注册CarService类中标记为@Tool的所有方法，作为ToolCallback实例。

CarService

CarService类是该项目的核心。它管理一个车辆列表并提供以下方法：

CarService中的方法

getCars()

• 工具名称: get_cars
• 描述: 获取Amarpreet心愿单中的车辆列表。
• 返回类型: List<Car>

getCar(String name)

• 工具名称: get_car_by_name
• 描述: 根据型号名称查找车辆。
• 参数:
  • name - 要搜索的型号名称。
• 返回类型: Car（未找到时为null）

getCarByYear(Integer year)

• 工具名称: get_car_by_years
• 描述: 根据制造年份查找车辆。
• 参数:
  • year - 要搜索的年份。
• 返回类型: Car（未找到时为null）

初始化

在CarService类中，使用@PostConstruct注解在应用程序启动期间初始化车辆列表：

@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)
    ));
}

运行方法

使用Maven构建项目:

mvn clean install

运行应用程序:

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

配置

该项目可以通过位于src/main/resources中的application.properties文件进行配置。关键属性包括：

• spring.application.name: 应用程序的名称。
• spring.main.web-application-type: 设置为none以创建非Web应用程序。
• spring.ai.mcp.server: MCP服务器的名称。
• spring.ai.mcp.version: MCP服务器的版本。

这个项目展示了如何使用Spring AI的工具回调API将业务逻辑暴露给AI，以便与其交互。视频演示应该能够更直观地展示功能是如何工作的。