Cars MCP Server

Cars MCP Server

这是一个使用 Spring AI 构建的 MCP（Model Context Protocol）服务。该项目演示了如何使用 Spring AI 的 ToolCallback API，公开用于与汽车列表交互的工具；该列表代表 Amarpreet 的愿望清单。

演示

演示视频

项目结构

项目组织如下：

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

  • CarsmcpserverApplication.java：Spring Boot 应用程序的主入口。它负责初始化应用程序，并使用 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 类使用 ToolCallbacks.from() 方法注册这些工具。

工具注册

在 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 注解初始化汽车列表：

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 服务的版本。