Carsmcpserver

🚀 マイルストーンプロトコル（MCP）自動車サーバー

このプロジェクトは、Spring AIをベースに構築されたMCP（モデルコンテキストプロトコル）サーバーです。これを通じて、Spring AIのToolCallback APIを使ってツールを公開し、Amarpreetのウィッシュリストにある車両リストを処理する方法を示しています。

🚀 クイックスタート

このサーバーを使用することで、Amarpreetのウィッシュリストにある車両情報を効率的に管理することができます。以下に、基本的な使い方を説明します。

🔍 デモ

デモビデオ

📁 プロジェクト構造

プロジェクトは以下のように構成されています。

• src/main/java/com/amarpreet/carsmcpserver/
  • CarsmcpserverApplication.java：アプリケーションのメインエントリーポイントです。アプリケーションを初期化し、CarServiceクラスを使ってToolCallback beanを登録します。
  • Car.java：車両を表すシンプルなrecordクラスで、modelNameとbuildYearの2つのフィールドを持ちます。
  • 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：非Webアプリケーションを作成するためにnoneに設定します。
• spring.ai.mcp.server：MCPサーバーの名前。
• spring.ai.mcp.version：MCPサーバーのバージョン。

このプロジェクトは、Spring AIのツールコールバックAPIを使ってビジネスロジックをAIに公開し、それとやり取りする方法を示しています。デモビデオを見ることで、機能がどのように動作するかをより直感的に理解することができます。