SuperAPI AI 工具集

java-mcp-server-generator

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:当用户希望在 Java 或 Spring Boot 应用中创建 MCP 服务器,或让 AI 智能体接入 MCP 时使用本技能。它基于官方 MCP Java SDK 2.x,SDK 2.0.x 支持 MCP 规范 2025-11-25 及更早版本,SDK 3.x 将加入 2026-07-28 版本。

主要能力:按五步工作流推进——创建项目、编写服务器、编写测试、构建至测试通过、配置客户端。默认使用 Maven,项目含 pom.xml 与主类、测试类;若项目用 Gradle 或用户要求 Gradle,则参考 references/gradle.md。默认使用 stdio 传输,仅在用户要求远程、HTTP 或 Spring Boot 服务器时参考 references/streamable-http.md。

使用方式:pom.xml 引入 io.modelcontextprotocol.sdk:mcp-bom 2.0.1、mcp、slf4j-simple 与 JUnit,并用 maven-shade-plugin 打包可执行 JAR。服务器以 McpServer.sync 加 StdioServerTransportProvider 构建,为每个工具写一个方法,提供 JSON Schema inputSchema 与 description;需要机器可读数据时加 outputSchema 并返回 structuredContent,同时附文本内容。只读工具用 readOnlyHint(true),破坏性工具用 destructiveHint(true)。测试以子进程启动服务器并用 SDK 客户端连接,使用运行 Maven 的 JDK 的 java 命令而非 PATH。构建运行 mvn verify,生成 target/mcp-server-demo-0.1.0.jar。客户端配置写入 .vscode/mcp.json 或 claude_desktop_config.json,命令为 java -jar 该 JAR 的绝对路径。

限制与注意:SDK 2.x 与 0.x/1.x 模式差异大,勿复制旧示例;必填字段不可为 null;工具名限 1 至 128 字符(字母、数字、_、-、.);schema 按 JSON Schema 2020-12 校验;工具失败应返回 isError(true) 的 CallToolResult 而非抛异常;stdio 服务器中 stdout 是协议通道,不可 System.out.println(),日志用 SLF4J 输出到 stderr;Spring 传输已移至 Spring AI 2.0 及以后(org.springframework.ai),不要用 mcp-spring-* 构件;不要用已弃用的 SSE 传输;2026-07-28 版本弃用 Sampling、协议日志与 Roots。资料未提供具体收费、价格与效果信息。