目前網上能看到的 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 {@Testpublic 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);}
}
運行單測后:
