Swagger Mcp Bridge
by Neo1228communityv0.1.0
3
4
This MCP server bridges a Spring Boot application’s SpringDoc OpenAPI operations into MCP tools, exposing API operations plus gateway/meta tools for discovery, validation, planning, and execution. It also adds response shaping and safety guardrails such as required-argument checks, risky-operation confirmation, and header filtering.
From the registry: Spring Boot example that exposes SpringDoc OpenAPI operations as safe MCP tools.
Install & configure
Prerequisites
- requiredInstall Java 17+A Java 17 or newer runtime is required to run a Spring Boot app using this starter.https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html/
- requiredCreate a Spring Boot app with Spring Web and SpringDocThis project is not a standalone npm/package command. You add the Maven/Gradle dependency io.github.neo1228:openapi-mcp-spring-boot-starter to your own Spring Boot application that already exposes OpenAPI via SpringDoc.
- requiredAdd the starter dependencyAdd io.github.neo1228:openapi-mcp-spring-boot-starter to your build along with org.springdoc:springdoc-openapi-starter-webmvc-api, then run your Spring Boot application.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `swagger-mcp-bridge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Java 17+** — A Java 17 or newer runtime is required to run a Spring Boot app using this starter. (https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html/)
- **Create a Spring Boot app with Spring Web and SpringDoc** — This project is not a standalone npm/package command. You add the Maven/Gradle dependency io.github.neo1228:openapi-mcp-spring-boot-starter to your own Spring Boot application that already exposes OpenAPI via SpringDoc.
- **Add the starter dependency** — Add io.github.neo1228:openapi-mcp-spring-boot-starter to your build along with org.springdoc:springdoc-openapi-starter-webmvc-api, then run your Spring Boot application.
Canonical MCP server config (HTTP transport):
- url: `http://<your-host>:<your-port>/mcp`
Note: This server is exposed by your own Spring Boot application over Streamable HTTP, configured with spring.ai.mcp.server.protocol=STREAMABLE_HTTP and spring.ai.mcp.server.streamable-http.mcp-endpoint=/mcp. The README does not define any MCP client env vars or auth headers. Default example endpoint is /mcp, commonly on port 8080 after you run the app. The bridge is installed as a Java/Spring dependency, not as a standalone MCP command.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: This server is exposed by your own Spring Boot application over Streamable HTTP, configured with spring.ai.mcp.server.protocol=STREAMABLE_HTTP and spring.ai.mcp.server.streamable-http.mcp-endpoint=/mcp. The README does not define any MCP client env vars or auth headers. Default example endpoint is /mcp, commonly on port 8080 after you run the app. The bridge is installed as a Java/Spring dependency, not as a standalone MCP command.
Tools (8)
meta_get_api_capabilities
Returns API catalog stats, gateway tools, orchestration features, safety policy, and response controls.
meta_list_api_groups
Summarizes the exposed API catalog by OpenAPI tag or group.
meta_discover_api_tools
Finds relevant operations for a natural-language request.
meta_describe_api_tool
Returns a tool’s method, path, parameters, required arguments, request schema, risk flags, and full MCP input schema.
meta_validate_api_call
Validates a generated API tool call without dispatching HTTP.
meta_plan_api_workflow
Turns a workflow goal into a deterministic candidate step plan.
meta_invoke_api_workflow
Dry-runs or executes multiple generated API tools sequentially.
meta_invoke_api_by_intent
Selects and invokes the best matching operation when enough arguments are provided.
Packages
ghcr.io/neo1228/swagger-mcp-bridge-example:0.1.0
ocitransport: streamable-http
Details
- Language
- Java
- License
- Apache-2.0
- Released
- May 3, 2026
- Last commit
- Jun 28, 2026
- Registry name
- io.github.Neo1228/swagger-mcp-bridge