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 传输方式。

相关推荐
androidwork3 分钟前
Fragment事务commit与commitNow区别
android·java·kotlin
WispX88833 分钟前
【手写系列】手写 AQS 实现 MyLock
java·开发语言·并发·aqs··手写·lock
初叶 crmeb38 分钟前
JAVA单商户易联云小票打印替换模板
java·linux·python
Goboy44 分钟前
《我养的修仙 AI 会渡劫》:我用 Trae 把它“说”出来了
ai编程·mcp·trae
RainbowSea44 分钟前
秒杀/高并发解决方案+落地实现 (技术栈: SpringBoot+Mysql + Redis +RabbitMQ +MyBatis-Plus +Maven-5
java·spring boot·分布式
汤姆yu1 小时前
基于springboot的民间文化艺术品销售系统
java·spring boot·后端
KenXu1 小时前
🔥 前端开发三大神器助你快速进入"傻瓜"时代
前端·mcp
二进制小甜豆1 小时前
Spring MVC
java·后端·spring·mvc
Yvonne9781 小时前
定时任务:springboot集成xxl-job-core(一)
java·spring boot·xxl-job
泰勒疯狂展开1 小时前
Java研学-MongoDB(一)
java·开发语言·mongodb