🚀 基於spring-ai-starter-mcp-server的自定義mcp server簡單示例，獲取當前時間

本項目是一個基於Spring AI Starter MCP Server的自定義MCP服務器示例，主要展示瞭如何運用MCP協議創建一個能返回當前系統時間的自定義時間服務，為需要精確時間戳的應用場景提供支持。

🚀 快速開始

運行項目

將項目打包並運行：

mvn spring-boot:run

驗證服務

訪問 /current-time 端點，查看當前時間：

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

✨ 主要特性

基於Spring Boot框架搭建，具備Spring Boot的高效與便捷。
集成MCP通信協議，實現特定的通信功能。
提供獲取當前時間的功能，適用於需要精確時間戳的場景。

📦 安裝指南

本項目無需額外的安裝步驟，直接使用以下命令運行即可：

mvn spring-boot:run

💻 使用示例

基礎用法

通過以下命令啟動項目：

mvn spring-boot:run

啟動成功後，使用以下命令獲取當前時間：

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

📚 詳細文檔

項目結構

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

配置文件

# application.properties
server.port=8090

# MCP服務器配置
mcp.server.name=mcp-time-server
mcp.server.ip=127.0.0.1
mcp.server.port=5000

核心代碼

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

🔧 技術細節

本項目基於Spring Boot框架搭建，利用Spring Boot的自動配置和依賴管理功能，快速搭建項目骨架。集成MCP通信協議，通過 McpServer 實現特定的通信功能。在 TimeController 中，使用 @GetMapping 註解處理HTTP GET請求，返回當前系統時間。配置文件通過 application.properties 進行配置，使用 @ConfigurationProperties 註解將配置文件中的屬性注入到 McpServerConfig 類中。