Skip to content

About

Read-only, sanitized Spring Boot runtime diagnostics (beans, conditions, routes, health, migrations, startup, config, OpenAPI, drift) for coding agents over MCP

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Spring Boot Runtime Diagnostics MCP

Chinese README

Give your coding assistant read-only access to the runtime state of a local Spring Boot application. Eight MCP tools use authorized Actuator and OpenAPI data to diagnose issues such as missing beans, unregistered routes, and slow startup.

Listed in Awesome MCP Servers (Developer Tools) · View the tools on Glama

What can it check?

Your question What it provides
Why was a Bean not created? Beans, dependencies and condition reports, with blocking chains when evidence is sufficient
Is this route registered? Actual paths, HTTP methods, Controllers and MVC/WebFlux mappings
What is unhealthy? Visible components and liveness/readiness status
Did a migration fail? Reported Flyway/Liquibase records, states and checksums
What made startup slow? Slow steps and their parent chains
Where did a configuration value come from? Sources for registered properties; configuration diagnostics require opt-in
Is this API in OpenAPI? Operations, schemas and references within the document
Does the process match my expectations? Compare the Bean, route, migration version and profile expectations you supply

For example, ask: “Check whether GET /orders/{id} is registered and tell me which Controller handles it.” The server reads mapping metadata without calling the business endpoint.

Get started

Try the demo without a Spring Boot app

The synthetic route demo uses the public package and bundled data to show which controller handles a route. It runs without a Spring process or an MCP client.

Connect an MCP client to your app

You need Python 3.11+, uv and permission to read a local Spring Boot application's management endpoints. Confirm the endpoints and permissions in the target setup guide. These commands use 0.2.14 Alpha.

uvx --default-index https://pypi.org/simple spring-runtime-mcp==0.2.14 --version
uvx --default-index https://pypi.org/simple spring-runtime-mcp==0.2.14 --base-url http://127.0.0.1:18081

Use the second command as your MCP client's STDIO server command. In a terminal it waits for client requests. Follow the English first-query guide; additional client configuration templates cover other clients.

Share first-query feedback

Boundaries

The server connects only to loopback addresses, uses fixed endpoints and supports optional Bearer authentication from a named environment variable. OpenAPI uses /actuator/openapi. Configuration diagnostics are disabled by default and require explicit opt-in via CLI flags (--config-prefix, --config-property, --config-profiles). When enabled, values remain hidden unless both --config-allow-values and the tool’s includeValues=true are set. Output is sanitized, and each tool response is capped at 16 KiB. Missing evidence is reported as partial/unknown.

Tools do not write to the target, restart applications, or read heap dumps or raw logs. The complete Boot/Java/client matrix, Windows/macOS and production-cluster compatibility remain unverified.

Documentation · Tool contract · Source facts · Development and checks

Apache-2.0 · Contributing · Report a security issue

About

Read-only, sanitized Spring Boot runtime diagnostics (beans, conditions, routes, health, migrations, startup, config, OpenAPI, drift) for coding agents over MCP

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages