Spring MCP 服务器

模型上下文协议（Model Context Protocol）是一个开放标准，允许开发者在其数据源和AI工具之间建立安全的双向连接。该架构简单：开发者可以将自己的数据通过MCP服务器公开，或构建AI应用程序（MCP客户端）以连接到这些服务器。

先决条件

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

快速入门

在此示例中，我们将创建一个简单的Spring Boot应用程序，作为MCP服务器。

1. 创建Spring Boot应用程序

使用Spring Initializr或其他 preferred method创建新的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中使用它。

图片说明

• 图1: 显示了如何在Claude Desktop中配置MCP服务器。
• 图2: 展示了如何测试MCP服务器。