Spring MCP Server

🚀 Spring MCP 服務器

模型上下文協議（Model Context Protocol）是一個開放標準，它允許開發者在其數據源和AI工具之間建立安全的雙向連接。該架構十分簡單，開發者既可以將自己的數據通過MCP服務器公開，也可以構建AI應用程序（MCP客戶端）以連接到這些服務器。

🚀 快速開始

在此示例中，我們將創建一個簡單的Spring Boot應用程序，作為MCP服務器。

1. 創建Spring Boot應用程序

使用Spring Initializr或其他偏好的方法創建新的Spring Boot應用程序。請確保包含以下依賴項：

• Spring Model Context Protocol Server

創建記錄類

創建一個表示要通過MCP服務器公開的信息的記錄類。

package org.sehn.spring_mcp;

public record Info(String title, String url) {
}

創建服務類

創建提供要在MCP服務器上公開信息的服務類。

package org.sehn.spring_mcp;

import jakarta.annotation.PostConstruct;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.List;

@Service
public class InfoService {

    private static final Logger logger = LoggerFactory.getLogger(InfoService.class);

    private List<Info> information = new ArrayList<>();

    @Tool(name = "dr_get_information", description = "Get a list of information about Deepanshu Rawat")
    public List<Info> getInformation() {
        return information;
    }

    @Tool(name = "dr_get_info", description = "Get a specific information about Deepanshu Rawat")
    public Info getInfo(String title) {
        return information.stream().filter(info -> info.title().equals(title)).findFirst().orElse(null);
    }

    @PostConstruct
    public void init() {
        information.addAll(List.of(
                new Info("Portfolio", "https://bento.me/deepanshu-rawat6"),
                new Info("GitHub", "https://github.com/deepanshu-rawat6"),
                new Info("LinkedIn", "https://www.linkedin.com/in/deepanshu-rawat6/"),
                new Info("Twitter", "https://twitter.com/deepanshuurawat")
        ));


    }
}

創建工具回調

在SpringMCPApplication或主應用程序類中，創建一個處理MCP服務器請求的工具回調。

    @Bean
    public List<ToolCallback> deepanshuTools(InfoService infoService) {
        return List.of(ToolCallbacks.from(infoService));
    }

添加配置

創建一個配置類來配置MCP服務器。

spring.application.name=spring_mcp
spring.main.web-application-type=none
spring.ai.mcp.server.name=spring_mcp
spring.ai.mcp.server.version=0.0.1


spring.main.banner-mode=off
logging.pattern.console=

2. 構建應用程序

運行以下命令構建應用程序：

mvn clean package -DskipTests

3. 進一步配置

為了使用MCP服務器，需要在claude_desktop_config.json中添加以下配置：

{
    "spring": {
        "application": {
            "name": "spring_mcp"
        },
        "main": {
            "web-application-type": "none"
        },
        "ai": {
            "mcp": {
                "server": {
                    "name": "spring_mcp",
                    "version": "0.0.1"
                }
            }
        }
    },
    "logging": {
        "pattern": {
            "console": ""
        }
    }
}

4. 測試MCP服務器

配置完成後，可以在Claude Desktop中測試MCP服務器。將以下內容添加到config.json文件：

{
    "servers": [
        {
            "url": "http://localhost:8080",
            "name": "spring_mcp"
        }
    ]
}

啟動服務器後，可以在Claude Desktop中使用它。

📦 安裝指南

先決條件

• Java 21
• Maven 3.9.9
• Spring Boot 3.4.4
• Spring AI 0.4.0
• Spring Model Context Protocol Server
• Claude Desktop Application

🖼️ 圖片說明

• 圖1：顯示瞭如何在Claude Desktop中配置MCP服務器。
• 圖2：展示瞭如何測試MCP服務器。