Java SolonMCP 实现 MCP 实践全解析：SSE 与 STDIO 通信模式详解

一、MCP简介

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

通俗点讲是：

一个专属的 RPC 协议

MCP的核心价值在于：

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

二、SolonMCP 简介

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

SolonMCP 的主要特点包括：

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

Maven 依赖包：

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-ai-mcp</artifactId>
    <version>3.3.1-M1</version>
</dependency>

Gradle 依赖包：

org.noear:solon-ai-mcp:3.3.1-M1

三、Java SolonMCP 实现 STDIO 方式

（1）基本示例

下面是一个使用 SolonMCP 实现 STDIO 通信方式的基本示例，创建一个简单的计算器工具 CalculatorTools：

@McpServerEndpoint(channel = McpChannel.STDIO)
public class CalculatorTools