MCP Host Project

MCP Host 项目

描述

本项目展示了如何在 Spring Boot 应用中集成 Spring AI 对 MCP（Model Context Protocol）的支持，涵盖服务端和客户端实现。

MCP

MCP 是一项标准，可简化 AI 模型中上下文交互的管理，从而实现与外部数据源和工具的一致集成。

Spring AI MCP 扩展了 MCP Java SDK，并为客户端和服务端提供专用的 Spring Boot starter。

MCP 客户端负责与 MCP 服务进行通信和连接管理。

在本项目中，我们使用 Spring AI 构建 MCP 服务，让大模型能够使用其功能。请注意，必须使用支持 TOOLS 的模型；我们通过 Ollama 使用 Llama3.2。

模块

本项目包含三个主要模块：

地理编码服务

• 端口：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 Host

• 描述：通过 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\nEnter city (or type 'exit' to quit): ");
            String city = scanner.nextLine();
            if ("exit".equalsIgnoreCase(city)) {
               break;
            }

            String queryTemplate = """
                    Please use the available tools to find the latitude and longitude for the city `{city}`. Once you have this information, 
                    use the tools to determine and provide all the timezone details for that location in the same language.
                    """;

            String systemTemplate = """
                    You are an AI assistant specialized in providing geographical information. Your task is to use the provided tools to gather and deliver accurate data.
                    """;

            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 Host：

   cd mcp-host
   mvn spring-boot:run
   

用法

1. 与 MCP Host 交互：
   • 运行 MCP Host 应用。
   • 在控制台中输入城市名称。
   • 系统将提供所输入城市的纬度、经度和时区信息。

插入图片