Swagger MCP 实战：基于 Spring Boot 与 Spring AI 将 OpenAPI 转为工具

Swagger MCP 实战：基于 Spring Boot 与 Spring AI 将 OpenAPI 转为工具 | 极客日志

server:
  port: 3000
transport:
  mode: sse
swagger:
  mcp:
    services:
      - serviceKey: local
        openapiUrl: http://127.0.0.1:9010/v3/api-docs/default
        baseUrl: http://127.0.0.1:9010
    toolMode: perOperation
    timeoutMs: 8000
    maxBodyBytes: 1048576
    auth:
      type: none

cd /d D:\workspace\langchain4j-spring-agent\langchain4j-spring-ai
mvn -pl langchain4j-spring-ai-swagger-mcp -am spring-boot:run

curl.exe -N "http://127.0.0.1:3000/sse"

curl.exe -X POST "http://127.0.0.1:3000/mcp/message?sessionId=你的 sessionId" ^
-H "Content-Type: application/json" ^
-d "{\"jsonrpc\":\"2.0\",\"id\":\"1\",\"method\":\"tools/list\",\"params\":{}}"

curl.exe -X POST "http://127.0.0.1:3000/mcp/message?sessionId=你的 sessionId" ^
-H "Content-Type: application/json" ^
-d "{\"jsonrpc\":\"2.0\",\"id\":\"2\",\"method\":\"tools/call\",\"params\":{\"name\":\"listOperations\",\"arguments\":{\"serviceKey\":\"local\"}}}"

curl.exe -X POST "http://127.0.0.1:3000/mcp/message?sessionId=你的 sessionId" ^
-H "Content-Type: application/json" ^
-d "{\"jsonrpc\":\"2.0\",\"id\":\"3\",\"method\":\"tools/call\",\"params\":{\"name\":\"call\",\"arguments\":{\"serviceKey\":\"local\",\"operationId\":\"getUserById\",\"args\":{\"id\":\"123\"}}}}"

Swagger MCP 实战：基于 Spring Boot 与 Spring AI 将 OpenAPI 转为工具

1. 背景与价值

2. 模块结构与启动入口

3. 核心组件解读

3.1 OpenApiLoader：加载与缓存

3.2 OpenApiNormalizer：规整接口结构

3.3 ToolSpecFactory：生成工具规范

3.4 OpenApiInvoker：执行调用

3.5 SwaggerCallTool：MCP 工具入口

4. MCP 服务配置与启动

5. 调用闭环（SSE 示例）

5.1 建立 SSE 会话

5.2 列出工具

5.3 获取 operationId 列表

5.4 通用调用

6. 设计要点与可扩展点

7. 常见问题（排障思路）

8. 小结

更多推荐文章

相关免费在线工具

Swagger MCP 实战：基于 Spring Boot 与 Spring AI 将 OpenAPI 转为工具

1. 背景与价值

2. 模块结构与启动入口

3. 核心组件解读

3.1 OpenApiLoader：加载与缓存

3.2 OpenApiNormalizer：规整接口结构

3.3 ToolSpecFactory：生成工具规范

3.4 OpenApiInvoker：执行调用

3.5 SwaggerCallTool：MCP 工具入口

4. MCP 服务配置与启动

5. 调用闭环（SSE 示例）

5.1 建立 SSE 会话

5.2 列出工具

5.3 获取 operationId 列表

5.4 通用调用

6. 设计要点与可扩展点

7. 常见问题（排障思路）

8. 小结

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具