Carsmcpserver

🚀 里程牌協議（MCP）汽車服務器

本項目是一個基於Spring AI構建的MCP（模型上下文協議）服務器。它展示瞭如何利用Spring AI的ToolCallback API公開工具，從而處理Amarpreet心願單中的車輛列表，為車輛數據的管理和交互提供了便捷的解決方案。

🚀 快速開始

運行方法

使用Maven構建項目

mvn clean install

運行應用程序

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

✨ 主要特性

• 基於Spring AI構建，利用ToolCallback API將業務邏輯暴露給AI進行交互。
• 管理Amarpreet心願單中的車輛列表，提供獲取車輛信息的多種方法。

📦 安裝指南

該項目可通過Maven進行構建，具體命令如下：

mvn clean install

💻 使用示例

基礎用法

在CarsmcpserverApplication.java中使用ToolCallback API註冊工具：

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

此代碼會註冊CarService類中標記為@Tool的所有方法，作為ToolCallback實例。

高級用法

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

此代碼在應用程序啟動時初始化車輛列表。

📚 詳細文檔

演示

演示視頻

項目結構

項目組織如下：

• 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驅動的接口訪問。

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）

配置

該項目可通過位於src/main/resources中的application.properties文件進行配置，關鍵屬性包括：