Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 TrackMCP. All rights reserved.

Built with ❤️ by Krishna Goyal

    Spring Ai Mcp Test

    Showcases how to integrate Spring AI's support for MCP (Model Context Protocol) within Spring Boot applications, covering both server-side and client-side implementations.

    2 stars
    Java
    Updated Mar 29, 2025
    mcp
    mcp-client
    mcp-server
    spring
    spring-ai
    spring-ai-ollama
    springboot

    Table of Contents

    • Description
    • MCP
    • Modules
    • Geocoder Service
    • Timezone Service
    • MCP Host
    • Running the Project
    • Usage

    Table of Contents

    • Description
    • MCP
    • Modules
    • Geocoder Service
    • Timezone Service
    • MCP Host
    • Running the Project
    • Usage

    Documentation

    MCP Host Project

    Description

    This project showcases how to integrate Spring AI's support for MCP (Model Context Protocol) within Spring Boot applications,

    covering both server-side and client-side implementations.

    MCP

    MCP is a standard that streamlines the management of contextual interactions in AI models, enabling consistent integration

    with external data sources and tools.

    Spring AI MCP extends the MCP Java SDK

    and provides dedicated Spring Boot starters for both clients and servers.

    The MCP client handles communication and connection management with MCP servers.

    In this project, we leverage Spring AI to build MCP servers, making their capabilities available to LLMs.

    Note that the use of a model supporting TOOLS is required; we are using Llama3.2 via Ollama.

    Modules

    This project consists of three main modules:

    Geocoder Service

    • Port: 8081
    • Description: Provides latitude and longitude for a given city.
    • configuration
    java
    public interface Geocoder {
        GeoCodeResult geocode(String city) throws Exception;
    }
    
    public record GeoCodeResult(double latitude, double longitude) {}

    Timezone Service

    • Port: 8082
    • Description: Provides timezone information for a given latitude and longitude.
    • configuration
    java
    public interface TimeZoneService {
        Optional getTimeZoneFromLocation(double latitude, double longitude) throws Exception;
    }
    public record TimeZone(
            String id,
            String name,
            int rawOffset,
            int dstSavings
    ) {}

    MCP Host

    • Description: Uses the Geocoder and Timezone services via MCP clients and provides a console interface to interact with an LLM.
    • configuration
    java
    @Bean
    CommandLineRunner runner(final ChatClient.Builder chatClientBuilder, List 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);
             }
          }
       };
    }

    Running the Project

    1. Start Geocoder Service:

    bash
    cd geocoder
        mvn spring-boot:run

    2. Start Timezone Service:

    bash
    cd timezone
        mvn spring-boot:run

    3. Start MCP Host:

    bash
    cd mcp-host
        mvn spring-boot:run

    Usage

    1. Interact with MCP Host:

    • Run the MCP Host application.
    • Enter city names in the console.
    • The system will provide latitude, longitude, and timezone information for the entered city.

    Insertamos image

    image

    Similar MCP

    Based on tags & features

    • MC

      Mcp Aoai Web Browsing

      Python·
      30
    • MC

      Mcpjungle

      Go·
      617
    • MC

      Mcp Open Library

      TypeScript·
      42
    • DA

      Davinci Resolve Mcp

      Python·
      327

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • MC

      Mcp Aoai Web Browsing

      Python·
      30
    • MC

      Mcpjungle

      Go·
      617
    • MC

      Mcp Open Library

      TypeScript·
      42
    • DA

      Davinci Resolve Mcp

      Python·
      327

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k