Spring Ai MCP Test

🚀 MCP 主機項目

本項目展示瞭如何在Spring Boot應用程序裡集成Spring AI對MCP（模型上下文協議）的支持，涵蓋了服務器端和客戶端的實現，為AI模型上下文交互管理提供了有效的解決方案。

🚀 快速開始

運行項目

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 主機應用程序。
   • 在控制檯中輸入城市名稱。
   • 系統將提供輸入城市的緯度、經度和時區信息。

插入圖片

✨ 主要特性

MCP 標準

MCP 是一個標準，旨在簡化AI模型上下文交互的管理，使其能夠與外部數據源和工具保持一致集成。
Spring AI MCP 擴展了MCP Java SDK，並提供了專門針對Spring Boot的客戶端和服務器端啟動器。

MCP 客戶端與服務器

MCP 客戶端負責處理與MCP 服務器之間的通信和連接管理。
在此項目中，我們利用Spring AI構建MCP 服務器，並使其功能可供大型語言模型（LLM）使用。需要注意的是，必須使用支持TOOLS 的模型；我們正在使用通過Ollama提供的Llama3.2。

📦 安裝指南

本項目的安裝主要通過Maven命令完成，具體啟動各服務的命令如下：

地理編碼服務

cd geocoder
mvn spring-boot:run

時區服務

cd timezone
mvn spring-boot:run

MCP 主機

cd mcp-host
mvn spring-boot:run

💻 使用示例

基礎用法

地理編碼服務接口

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

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

時區服務接口

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

MCP 主機交互代碼

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

📚 詳細文檔

模塊介紹

此項目由三個主要模塊組成：

地理編碼服務

• 端口：8081
• 描述：根據城市名稱提供緯度和經度。
• 配置

時區服務

• 端口：8082
• 描述：根據緯度和經度提供時區信息。
• 配置

MCP 主機

• 描述：通過MCP 客戶端使用地理編碼和時區服務，並提供一個控制檯界面與LLLM交互。
• 配置

MCP 相關說明

MCP 是一個標準，旨在簡化AI模型上下文交互的管理，使其能夠與外部數據源和工具保持一致集成。
Spring AI MCP 擴展了MCP Java SDK，並提供了專門針對Spring Boot的客戶端和服務器端啟動器。

MCP 客戶端負責處理與MCP 服務器之間的通信和連接管理。
在此項目中，我們利用Spring AI構建MCP 服務器，並使其功能可供大型語言模型（LLM）使用。需要注意的是，必須使用支持TOOLS 的模型；我們正在使用通過Ollama提供的Llama3.2。