Spring Ai MCP Test

🚀 MCP ホストプロジェクト

このプロジェクトは、Spring Bootアプリケーションにおいて、Spring AIを用いてMCP（モデルコンテキストプロトコル）のサポートを統合する方法を示しています。サーバー側とクライアント側の実装を網羅しています。

🚀 クイックスタート

MCPについて

MCPは、AIモデルのコンテキストインタラクションの管理を簡素化し、外部のデータソースやツールとの統合を可能にする標準です。
Spring AI MCP は、MCP Java SDK を拡張し、Spring Boot向けのクライアントとサーバー側のスターターを提供しています。

MCPクライアントは、MCPサーバーとの通信や接続管理を担当します。
このプロジェクトでは、Spring AIを利用してMCPサーバーを構築し、その機能を大規模言語モデル（LLM）で使用できるようにしています。なお、TOOLSをサポートするモデルを使用する必要があります。ここではOllamaを通じて提供されるLlama3.2を使用しています。

モジュール構成

このプロジェクトは、3つの主要なモジュールで構成されています。

地理コーディングサービス

• ポート：8081
• 説明：都市名から緯度と経度を提供します。
• 設定

public interface Geocoder {
    GeoCodeResult geocode(String city) throws Exception;
}

public record GeoCodeResult(double latitude, double longitude) {}

タイムゾーンサービス

• ポート：8082
• 説明：緯度と経度からタイムゾーン情報を提供します。
• 設定

public interface TimeZoneService {
    Optional<TimeZone> getTimeZoneFromLocation(double latitude, double longitude) throws Exception;
}
public record TimeZone(
        String id,
        String name,
        int rawOffset,
        int dstSavings
) {}

MCPホスト

• 説明：MCPクライアントを介して地理コーディングとタイムゾーンサービスを利用し、コンソールインターフェースを通じてLLLMと対話できます。
• 設定

@Bean
CommandLineRunner runner(final ChatClient.Builder chatClientBuilder, List<ToolCallback> toolCallbacks) {

   final ChatClient agent = chatClientBuilder.build();

   return args -> {
      try (Scanner scanner = new Scanner(System.in)) {
         while (true) {
            System.out.print("\n\n都市名を入力してください（'退出'と入力すると終了します）：");
            String city = scanner.nextLine();
            if ("退出".equalsIgnoreCase(city)) {
               break;
            }

            String queryTemplate = """
                    利用可能なツールを使用して、指定された都市`{city}`の緯度と経度を取得してください。この情報を取得した後、ツールを使用してその位置のタイムゾーンの詳細情報を提供し、同じ言語で返してください。
                    """;

            String systemTemplate = """
                    あなたは地理情報を提供するAIアシスタントです。提供されたツールを利用して正確なデータを収集し、伝えることがあなたの任務です。
                    """;

            String llmResponse = agent
                    .prompt()
                    .advisors(new SimpleLoggerAdvisor())
                    .system(systemSpec -> systemSpec.text(systemTemplate))
                    .user(userSpec -> userSpec.text(queryTemplate).param("city", city))
                    .tools(toolCallbacks)
                    .call()
                    .content();

            log.info("\n\n{}", llmResponse);
         }
      }
   };
}

プロジェクトの実行方法

1. 地理コーディングサービスの起動：

   cd geocoder
   mvn spring-boot:run
   

2. タイムゾーンサービスの起動：

   cd timezone
   mvn spring-boot:run
   

3. MCPホストの起動：

   cd mcp-host
   mvn spring-boot:run
   

使用方法

1. MCPホストとの対話：
   • MCPホストアプリケーションを実行します。
   • コンソールに都市名を入力します。
   • システムは入力した都市の緯度、経度、タイムゾーン情報を提供します。

挿入画像