Java Solon-MCP 实现 MCP 实践全解析:SSE 与 STDIO 通信模式详解

一、MCP简介

MCP(Model Context Protocol,模型上下文协议)是由Anthropic公司于2024年推出的开放标准,旨在统一AI模型与外部数据源、工具之间的通信方式。MCP提供了一套规范化的接口,使大语言模型(LLM)能够更便捷地与各类外部工具和资源进行交互。

通俗点讲是:

java 复制代码
一个专属的 RPC 协议

MCP的核心价值在于:

  • 标准化接口:为AI模型提供统一的工具发现和使用接口
  • 安全通信:定义了一套安全的模型与工具之间的通信协议
  • 跨平台兼容:适用于不同AI提供商的模型
  • 提升AI能力:让AI能够访问最新数据和执行复杂操作

二、Solon-MCP 简介

Solon-MCP(全名 Solon-AI-MCP)是一个基于 Java 的高级框架,专为构建 MCP 服务器而设计。它极大简化了 MCP 服务器的开发流程,让开发者能够以最小的代码量创建功能强大的MCP服务器。

Solon-MCP 的主要特点包括:

  • 简洁的 API:通过装饰器模式,简化MCP服务器的创建
  • 丰富的功能:支持工具(Tools)、资源(Resources)、提示模板(Prompts)等MCP核心元素
  • 多种传输方式:支持 STDIO 和 SSE 等不同传输协议
  • 类型安全:利用 Java 的类型提示,自动生成 MCP 协议所需的模式定义
  • 内置图像处理:支持图像数据的自动格式转换和处理
  • 使用 Solon-MCP,开发者可以专注于业务逻辑,而不必过多关注底层协议细节。

三、Java Solon-MCP 实现 STDIO 方式

(1)基本示例

下面是一个使用 Solon-MCP 实现 STDIO 通信方式的基本示例,创建一个简单的计算器工具 CalculatorTools:

java 复制代码
@McpServerEndpoint(channel = McpChannel.STDIO)
public class CalculatorTools {
    @ToolMapping(description = "将两个数字相加")
    public int add(@Param int a, @Param int b) {
        return a + b;
    }

    @ToolMapping(description = "从第一个数中减去第二个数")
    public int subtract(@Param int a, @Param int b) {
        return a - b;
    }

    @ToolMapping(description = "将两个数相乘")
    public int multiply(@Param int a, @Param int b) {
        return a * b;
    }

    @ToolMapping(description = "将第一个数除以第二个数")
    public float divide(@Param float a, @Param float b) {
        return a / b;
    }
}

在这个示例中,我们:

  • 创建了一个名为 CalculatorTools 的 MCP 服务器实例
  • 使用 @ToolMapping 注解定义了四个计算工具
  • 通过 @McpServerEndpoint(channel = McpChannel.STDIO) 以 STDIO 模式启动服务器

4.2 运行和使用

(先打包成 jar 胖包)运行 STDIO 模式的 MCP 服务器:

java 复制代码
java -jar demo.jar

在这种模式下,服务器将等待标准输入上的请求,然后通过标准输出返回响应。所有支持 STDIO 模式的 MCP 客户端(或工具,或中间件),都可以连接使用。

五、Java Solon-MCP 实现 SSE 方式

5.1 基本示例

下面是使用 Solon-MCP 实现 SSE 通信方式的示例,创建一个简单的天气服务:

java 复制代码
@McpServerEndpoint(sseEndpoint = "/mcp/sse")
public class WeatherTools {
    @ToolMapping(description = "获取指定城市的当前天气")
    public String get_weather(@Param String city) {
        return "{city: '" + city + "', temperature:[10,25], condition:['sunny', 'clear', 'hot'], unit:celsius}";
    }

    //给前端用,需要严格的 json 格式
    @Produces(MimeType.APPLICATION_JSON_VALUE)
    @ResourceMapping(uri = "weather://cities", description = "获取所有可用的城市列表")
    public List<String> get_available_cities() {
        return Arrays.asList("Tokyo", "Sydney", "Tokyo");
    }

    @ResourceMapping(uri = "weather://forecast/{city}", description = "获取指定城市的天气预报资源")
    public String get_forecast(@Param String city) {
         return "{city: '" + city + "', temperature:[10,25], condition:['sunny', 'clear', 'hot'], unit:celsius}";
    }
}

在这个示例中:

  • 我们创建了一个名为 "Weather Service" 的 MCP 服务器
  • 定义了一个 get_weather 工具函数,用于获取城市的当前天气
  • 添加了两个资源:一个返回所有可用城市的列表,另一个返回指定城市的天气预报
  • 通过指定 sseEndpoint 以 SSE 模式启动服务器

5.2 运行和使用

运行 SSE 模式的 MCP 服务器:

复制代码
java -jar demo.jar

服务器将在指定端口(默认为 8080)启动,并监听HTTP连接。您可以通过浏览器访问:

复制代码
http://localhost:8080/mcp/sse

要与此服务器交互,可以使用支持 SSE 传输的 MCP 客户端,或者使用如下 Java 代码创建一个简单的客户端:

java 复制代码
public void test() {
    McpClientProvider clientProvider = McpClientProvider.builder()
                .apiUrl("http://localhost:8080/mcp/sse")
                .build();

    String rst1 = clientProvider.callToolAsText("get_weather", Map.of("city", "杭州"))
                                .getContent();
                                   
    String rst2 = clientProvider.readResourceAsText("weather://cities")
                                .getContent();
}

六、总结

Java Solon-MCP 为开发者提供了一种简单高效的方式来构建 MCP 服务器,无论是使用 STDIO 还是 SSE 传输方式。

相关推荐
坐吃山猪4 小时前
SpringBoot01-配置文件
java·开发语言
我叫汪枫5 小时前
《Java餐厅的待客之道:BIO, NIO, AIO三种服务模式的进化》
java·开发语言·nio
yaoxtao5 小时前
java.nio.file.InvalidPathException异常
java·linux·ubuntu
Swift社区6 小时前
从 JDK 1.8 切换到 JDK 21 时遇到 NoProviderFoundException 该如何解决?
java·开发语言
DKPT7 小时前
JVM中如何调优新生代和老生代?
java·jvm·笔记·学习·spring
phltxy7 小时前
JVM——Java虚拟机学习
java·jvm·学习
seabirdssss9 小时前
使用Spring Boot DevTools快速重启功能
java·spring boot·后端
喂完待续9 小时前
【序列晋升】29 Spring Cloud Task 微服务架构下的轻量级任务调度框架
java·spring·spring cloud·云原生·架构·big data·序列晋升
benben0449 小时前
ReAct模式解读
java·ai