Hello MCP Server Current Time

🚀 Simple Example of Custom MCP Server Based on spring-ai-starter-mcp-server to Get Current Time

This project is a simple example of a custom MCP server based on Spring AI Starter MCP Server. The main purpose of this project is to demonstrate how to use the MCP protocol to create a custom time service that can return the current system time.

✨ Features

• Built on the Spring Boot framework.
• Integrated with the MCP communication protocol.
• Provides the function of getting the current time.

📦 Project Structure

src/main/java/
    com/example/mcptime/
        McpTimeApplication.java
        controller/
            TimeController.java
        config/
            McpServerConfig.java

📚 Configuration Files

# application.properties
server.port=8090

# MCP server configuration
mcp.server.name=mcp-time-server
mcp.server.ip=127.0.0.1
mcp.server.port=5000

💻 Usage Examples

Basic Usage

TimeController.java

package com.example.mcptime.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Date;

@RestController
public class TimeController {
    @GetMapping("/current-time")
    public String getCurrentTime() {
        return new Date().toString();
    }
}

McpServerConfig.java

package com.example.mcptime.config;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "mcp.server")
public class McpServerConfig {
    private String name;
    private String ip;
    private int port;

    // Getters and Setters omitted for brevity
}

McpTimeApplication.java

package com.example.mcptime;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.http.converter.protobuf.ProtobufHttpMessageConverter;
import org.springframework.remoting.mcp.McpServer;

@SpringBootApplication
@ComponentScan(basePackages = "com.example.mcptime")
public class McpTimeApplication {

    public static void main(String[] args) {
        SpringApplication.run(McpTimeApplication.class, args);
    }

    @Bean
    public McpServer mcpServer() {
        return new McpServer("tcp://127.0.0.1:5000");
    }
}

🚀 Quick Start

1. Package and run the project:

mvn spring-boot:run

2. Access the /current-time endpoint to view the current time:

curl http://localhost:8090/current-time

🔍 Project Summary

Through this example, it demonstrates how to quickly build a custom time service based on Spring Boot and the MCP protocol. This service can obtain the current system time through a simple HTTP request and is suitable for various application scenarios that require accurate timestamps.