Neo1228/spring-boot-starter-swagger-mcp

Overview

A Spring Boot starter that converts SpringDoc OpenAPI specifications into MCP tools. It enables discovery, validation, workflows, and guardrails for MCP-based interactions with Spring Boot services.

Best for

Best for
Spring Boot developers who want to expose their OpenAPI-defined services as MCP tools with minimal configuration

Use cases

• Expose OpenAPI endpoints as MCP tools in Spring Boot
• Add validation and guardrails to MCP workflows
• Automate discovery of SpringDoc API definitions for MCP

How to use

Tools exposed

• meta_get_api_capabilities
• meta_validate_api_call
• meta_discover_api_tools
• meta_describe_api_tool
• meta_list_api_groups
• meta_plan_api_workflow
• meta_invoke_api_workflow
• meta_invoke_api_by_intent

Tested with

Claude Desktop

Example client config

spring:\n  ai:\n    mcp:\n      server:\n        protocol: STREAMABLE_HTTP\n        streamable-http:\n          mcp-endpoint: /mcp\nswagger:\n  mcp:\n    enabled: true\n    api-docs-path: /v3/api-docs\n    tool-name-prefix: api_

Notes

A Spring Boot starter that converts SpringDoc OpenAPI specifications into MCP tools. It enables discovery, validation, workflows, and guardrails for MCP-based interactions with Spring Boot services.

2 stars on GitHub. Last updated 2026-05-17. Licensed Apache-2.0.

Use cases

• Expose OpenAPI endpoints as MCP tools in Spring Boot
• Add validation and guardrails to MCP workflows
• Automate discovery of SpringDoc API definitions for MCP

Pros

• Leverages existing SpringDoc OpenAPI setup for MCP conversion
• Provides built-in production-ready features like guardrails and validation
• Easy integration as a Spring Boot starter

Cons

• Low community adoption with only 2 stars on GitHub
• Tied to Spring Boot and SpringDoc, limiting flexibility outside that ecosystem
• May lack extensive documentation or examples due to early stage

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.