Solon AI MCP Server 入门：Helloworld （支持 java8 到 java24。国产解决方案）

news2025/4/19 12:31:56

目前网上能看到的 MCP Server 基本上都是基于 Python 或者 nodejs ，虽然也有 Java 版本的 MCP SDK，但是鲜有基于 Java 开发的。作为Java 开发中的国产顶级框架 Solon 已经基于 MCP SDK 在进行 Solon AI MCP 框架开发了，本文将使用 Solon AI MCP 做一个简单的 MCP Server 入门。

引入依赖

Solon AI MCP 是 Solon AI 最新增加的特性。支持 Mcp Server 和 Mcp Client，且支持 Java 8 到 Java 24。最新的版本号为 3.2.0（随 Solon 的版号）。

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

开始写工具

solon-ai-mcp 支持多端点的架构，可以手动构建端点，或者注解构建端点（@McpServerEndpoint）。再使用 @ToolMapping 注解编写工具，就像开发 MVC 一样简单和熟悉。

@ToolMapping 注解标记这个方法是一个工具映射，通过 description 属性告诉大模型这个工具是做什么的，其实就是提示词，大模型会根据自己的理解调用这个工具，所以这个描述很重要。
@ToolParam：从名字可以看出来，就是工具调用时需要传什么参数

@McpServerEndpoint(sseEndpoint = "/sse")
public class HelloService {
    @ToolMapping(description = "你好世界")
    public String hello(@ToolParam(description = "名字") String name) throws SQLException {
        return "hello " + name;
    }
}

这样就可以了。启动时就会自动注册。并且打印基本的信息：

用客户端做个单测（调用这个工具）

@Slf4j
@SolonTest(App.class)
public class HelloTest extends HttpTester {
    @Test
    public void hello() throws IOException {
        McpClientToolProvider clientToolProvider = McpClientToolProvider.builder()
                .apiUrl("http://localhost:8080/sse")
                .build();

        String rst = clientToolProvider.callToolAsText("hello", Maps.of("name", "solon"));
        log.warn(rst);
    }
}