Allows an AI client to inspect Spring Boot runtime data including beans, routes, health status, and database migrations via Actuator and OpenAPI.
Also known as neilmorse/spring-runtime-mcp, spring-runtime-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 4,404
- Latest version
- 0.2.12
- Last commit
- Nov 2, 2026
- License
- Apache-2.0
What is Spring Boot Runtime Diagnostics MCP?
Spring Boot Runtime Diagnostics allows an AI client to inspect Spring Boot runtime data including beans, routes, health status, and database migrations via Actuator and OpenAPI.
Summary generated from the project's README
About Spring Boot Runtime Diagnostics MCP server
Investigating live Spring Boot application behavior from inside an AI client is the primary function of this MCP server. It provides developers with direct access to runtime data by reading authorized Actuator and OpenAPI endpoints. By connecting to a local Spring Boot application via loopback addresses, the server allows an assistant to inspect beans, HTTP routes, health status, and database migration records from Flyway or Liquibase.
Setup requires Python 3.11+ and uv to run the server via a command that specifies a base URL. The server operates as a STDIO server for your client and can use optional Bearer authentication through a named environment variable. While it can inspect configuration properties if you opt-in using specific CLI flags like --config-prefix, it does not write to the target application, restart processes, or read raw logs or heap dumps. Each tool response is limited to 16 KiB to ensure manageable data transfer.
What you can do with it
- 1Debug bean creation issuesAsk the assistant to explain why a specific bean was not created by examining dependencies and condition reports.
- 2Verify API route registrationDetermine if a specific HTTP method and path are correctly mapped to a controller without calling the endpoint.
- 3Monitor database migration statusCheck if a migration failed by reviewing Flyway or Liquibase records and checksums.
- 4Analyze application startup performanceIdentify which steps caused a slow startup by looking at parent chains of slow steps.
Written from the project's README. Every use case is checked against a quote from it.
How to install Spring Boot Runtime Diagnostics MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Spring Boot Runtime Diagnostics MCP in Claude Code
$ claude mcp add spring-runtime-mcp -- uvx spring-runtime-mcpInstall Spring Boot Runtime Diagnostics MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"spring-runtime-mcp": {
"command": "uvx",
"args": [
"spring-runtime-mcp"
]
}
}
}Install Spring Boot Runtime Diagnostics MCP in VS Code
.vscode/mcp.json
{
"servers": {
"spring-runtime-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"spring-runtime-mcp"
]
}
}
}Install Spring Boot Runtime Diagnostics MCP in VS Code CLI
$ code --add-mcp '{"name":"spring-runtime-mcp","type":"stdio","command":"uvx","args":["spring-runtime-mcp"]}'Install Spring Boot Runtime Diagnostics MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"spring-runtime-mcp": {
"command": "uvx",
"args": [
"spring-runtime-mcp"
]
}
}
}Install Spring Boot Runtime Diagnostics MCP in Codex
$ codex mcp add spring-runtime-mcp -- uvx spring-runtime-mcpInstall Spring Boot Runtime Diagnostics MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.spring-runtime-mcp] command = "uvx" args = ["spring-runtime-mcp"]
Install Spring Boot Runtime Diagnostics MCP in Gemini CLI
$ gemini mcp add -s user spring-runtime-mcp uvx -- spring-runtime-mcpInstall Spring Boot Runtime Diagnostics MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"spring-runtime-mcp": {
"command": "uvx",
"args": [
"spring-runtime-mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableneilmorse/spring-runtime-mcp is public and reachablegithub.com/neilmorse/spring-runtime-mcp ↗Pass
- Package names this repository as its sourcespring-runtime-mcp names neilmorse/spring-runtime-mcp as sourcepypi.org/project/spring-runtime-mcp/ ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for spring-runtime-mcppypi.org/project/spring-runtime-mcp/ ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-02github.com/neilmorse/spring-runtime-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from spring-runtime-mcpPass
- No critical advisory in the package or its dependencies29 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSpring Boot Runtime Diagnostics MCP
Give your coding assistant access to what is actually running in a Spring Boot application. This MCP server reads authorized Actuator and OpenAPI data to help investigate Beans, routes, health, database migrations and startup problems.
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
You need Python 3.11+, uv and an authorized local Spring Boot application. Confirm its management endpoints and permissions using the target setup guide, then check and start 0.2.12 Alpha:
uvx --default-index https://pypi.org/simple spring-runtime-mcp==0.2.12 --version
uvx --default-index https://pypi.org/simple spring-runtime-mcp==0.2.12 --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.
Try the synthetic route demo using the public package without preparing an application, then share first-query feedback. The replay needs no Spring process and does not establish live application or client compatibility.
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
Spring Boot Runtime Diagnostics MCP questions
How do I add Spring Boot Runtime Diagnostics MCP to Claude Code?
Run claude mcp add spring-runtime-mcp -- uvx spring-runtime-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Spring Boot Runtime Diagnostics MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can the server check in a Spring Boot application?
It can investigate bean creation issues, registered HTTP routes, component health, database migration status, startup performance, and OpenAPI schemas.
Does the server modify the running application?
No, the server is read-only and does not write to the target, restart applications, or read heap dumps or raw logs.
How can I see configuration values?
Configuration diagnostics are disabled by default and require explicit opt-in via CLI flags, and values remain hidden unless specific flags are set.