本文介绍了使用 SpringBoot3 和 SSE 协议构建 MCP 服务器的完整实践，结合 OpenSpec 工件驱动开发流程。内容涵盖 MCP 协议概念、OpenSpec 设计提案与任务拆分、详细架构设计、核心代码实现包括 JSON-RPC 模型 SSE 控制器工具注册中心以及验证测试。通过示例工具展示如何集成 AI 能力，并提供了在客户端测试的具体步骤，旨在帮助开发者掌握 MCP 服务搭建及 AI 辅助开发方法。
本文介绍基于 SpringBoot3 和 OpenSpec 开发 MCP 服务器的完整流程，以 MCP 工具为例演示从需求、设计到实现的步骤。
MCP（Model Context Protocol） 是 Anthropic 推出的开放协议，用于规范 AI 应用与外部数据源的交互。
传统模式下，让 AI 访问数据库、文件系统、第三方 API，每接一个数据源都要写一套对接代码：认证、数据格式解析、错误处理… 重复劳动多，维护成本高。
MCP 规范了一套统一接口，数据源按标准实现后，AI 就能直接调用。
协议本身与传输层无关，采用 JSON-RPC 2.0 格式通信。
OpenSpec 是一个工件驱动的开发方法，通过结构化的文档规范开发过程。
AI 辅助编程时，经常出现需求理解偏差、代码偏离原始意图、后期验证困难等问题。OpenSpec 通过前置设计和后期验证，减少 AI 开发中的需求偏差和返工。
| 工件 | 描述 | 提示词 |
|---|---|---|
| Proposal | 设计提案，记录决策和权衡 | '我需要为 xxx 功能创建一个提案，包含技术选型、架构设计决策' |
| Tasks | 任务拆分 | '基于上面的提案，帮我拆解成具体的开发任务' |
| Design | 详细设计 | '基于任务列表，帮我设计类结构、接口定义' |
| Implementation | 代码实现 | '按照设计文档，实现具体的代码' |
| Verification | 验证归档 | '验证实现是否完整，整理归档' |
在 AI 辅助编程场景下，OpenSpec 流程能解决几个常见问题：
用 SpringBoot3 + SSE 实现一个基础的 MCP 服务器 Demo：
本项目将产出以下工件：
| 工件 | 内容 |
|---|---|
| Proposal | 技术选型、架构设计决策 |
| Tasks | 任务拆分和依赖关系 |
| Design | 类设计、接口定义 |
| Implementation | 核心代码实现 |
| Verification | 测试结果和归档 |
我想用 SpringBoot3 + SSE 实现一个 MCP 服务器 Demo，帮我创建一个提案。 需求： - 实现 Tools 能力（initialize、tools/list、tools/call） - 提供一个示例工具：查询日程（get_calendar_events） - 代码结构清晰，便于演示
传输层选型
最初考虑了三种方案：Stdio、WebSocket、SSE。
本示例项目使用 SSE 方案。
MCP 协议定义了多种能力，本 Demo 先聚焦 Tools（工具）。工具是 AI 可调用的函数，后续可根据需求扩展。
初步确定实现以下方法：
initialize - 初始化握手，协商协议版本
tools/list - 返回所有可用工具
tools/call - 执行指定工具
基于上面的提案，帮我拆解成具体的开发任务。
根据提案，把开发拆成以下任务：
| 任务 | 描述 | 依赖 |
|---|---|---|
| T1 | 项目初始化，添加 Web、SSE 依赖 | 无 |
| T2 | 实现 JSON-RPC 协议模型 | T1 |
| T3 | 实现 SSE Controller | T1 |
| T4 | 实现协议路由器 | T2, T3 |
| T5 | 实现 Tool 接口和注册中心 | T2 |
| T6 | 实现示例工具 | T5 |
基于任务列表，帮我做详细设计：类结构、核心接口、数据流转。
AI Client │ SSE │ ┌─────────────────────────────────────┐ │ SpringBoot Server │ │ │ │ ┌─────────────────────────────┐ │ │ │ MCP Protocol Handler │ │ │ └─────────────────────────────┘ │ │ │ │ │ ┌───────────────┼───────────────┐ │ │ ▼ ▼ ▼ │ │ Tool Registry Resource Registry Prompt │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ 工具实现 资源实现 提示实现 │ └─────────────────────────────────────┘
协议层
JsonRpcRequest / JsonRpcResponse - 纯粹的 POJO，只做序列化/反序列化McpHandler - 负责请求路由，不关心传输细节注册中心
ToolRegistry - 工具注册中心，利用 Spring 的 List<Tool> 自动注入Controller
SseEmitter 实现服务端推送public interface McpTool {
String getName(); // 工具名字
String getDescription(); // 描述，告诉 AI 什么时候用它
Map<String, Object> getInputSchema(); // 参数格式
String execute(Map<String, Object> arguments); // 执行逻辑
}
按照设计文档，实现以下功能： 1. JSON-RPC 协议模型（JsonRpcRequest、JsonRpcResponse） 2. 协议处理器（initialize、tools/list、tools/call） 3. SSE Controller（SseEmitter） 4. Tool 接口和注册中心 5. 日程查询工具（GetCalendarEventsTool），根据日期查询日程 使用 SpringBoot3 + Spring Web，用 @Component、@Autowired 进行依赖注入。
以下代码均由 AI 根据提案相关内容生成，此处主要为了方便理解贴出了部分关键代码。
用 start.spring.io 生成项目骨架，添加了 Spring Web 依赖。
协议格式是 MCP 规范定义好的，直接照搬：
public class JsonRpcRequest {
private String jsonrpc = "2.0";
private String method;
private Object params;
private Object id;
}
这部分是核心，路由逻辑如下：
public JsonRpcResponse handle(JsonRpcRequest request) {
return switch (request.getMethod()) {
case "initialize" -> handleInitialize(request);
case "tools/list" -> handleListTools(request);
case "tools/call" -> handleCallTool(request);
default -> JsonRpcResponse.error(-32601, "方法不存在", request.getId());
};
}
SSE 接口实现：
@PostMapping(value = "/mcp", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public SseEmitter handle(@RequestBody JsonRpcRequest request) {
SseEmitter emitter = new SseEmitter(60_000L);
CompletableFuture.runAsync(() -> {
try {
JsonRpcResponse response = mcpHandler.handle(request);
emitter.send(SseEmitter.event().data(objectMapper.writeValueAsString(response)));
emitter.complete();
} catch (Exception e) {
emitter.completeWithError(e);
}
});
return emitter;
}
利用 Spring 的依赖注入：
@Component
public class ToolRegistry {
private final Map<String, Tool> tools = new ConcurrentHashMap<>();
@Autowired
public void registerAllTools(List<Tool> toolList) {
toolList.forEach(tool -> tools.put(tool.getName(), tool));
}
}
这样所有实现 Tool 接口的 @Component 都会自动注册进来。
写了一个简单的日程查询工具：
@Component
public class GetCalendarEventsTool implements Tool {
@Override
public String getName() {
return "get_calendar_events";
}
@Override
public String getDescription() {
return "查询指定日期的日历事件";
}
@Override
public String execute(Map<String, Object> arguments) {
String date = (String) arguments.get("date");
return "2026-02-10 有 3 个会议";
}
}
验证实现是否完整，帮我生成归档报告。 需要验证： - JSON-RPC 协议解析和响应（initialize、tools/list、tools/call） - SSE 传输层 - 日程查询工具（get_calendar_events）调用
正向测试
→ POST /mcp {"method":"tools/list","id":1} ← {"jsonrpc":"2.0","result":{"tools":[{"name":"get_calendar_events",...}]},"id":1}
→ POST /mcp {"method":"tools/call","params":{"name":"get_calendar_events","arguments":{"date":"2026-02-10"}},"id":2} ← {"jsonrpc":"2.0","result":{"content":[{"type":"text","text":"..."}]},"id":2}
异常测试
→ POST /mcp {"method":"unknown","id":1} ← {"jsonrpc":"2.0","error":{"code":-32601,"message":"方法不存在"},"id":1}
openspec archive --change "<change-name>"
确保 MCP 服务器已启动：
# 编译并启动 SpringBoot 应用 ./gradlew bootRun # 服务器默认在 http://localhost:8080 运行
SSE 方式需要在 MCP 客户端和服务器之间建立 HTTP 连接。一种简单方式是使用 npx 直接调用：
# 启动 MCP 服务器（另一个终端）# 添加 MCP 服务 claude mcp add--transport http --scope user calendar-mcp http://localhost:8080/mcp
在 Claude Code 对话中直接测试：
请调用 get_calendar_events 工具，查询今天的日程
Started McpServerApplication in x seconds测试接口是否正常返回：
curl -X POST http://localhost:8080/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
本文基于 SpringBoot3 和 SSE 实现最小可用 MCP 服务器，并通过 OpenSpec 工件驱动流程，从提案到实现完整演示 AI 辅助后端开发的技术落地实践，希望能给大家一些关于 OpenSpec 与 MCP 开发使用的参考。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online