mcp -springboot
LLM MCP service using Springboot Java
claude mcp add --transport stdio ranjeet-floyd-mcp-server-springboot java -jar target/mcp-server.jar \ --env JAVA_OPTS="Options for the JVM if needed" \ --env SPRING_PROFILES_ACTIVE="desired Spring profile (e.g., default)"
How to use
This MCP server is implemented with Spring Boot, providing a Java-based MCP (Model Context Protocol) server for language model coordination and prompt management. The repository uses the Maven wrapper to build and run the application locally. After building, you can start the server with the embedded Spring Boot run capabilities, which exposes the MCP endpoints described in the MCP Spring Boot starter documentation. Use the included REST endpoints to register, manage, and query MCP components, as well as to coordinate prompt flows and model interactions within your workspace.
How to install
Prerequisites:
- JDK 11+ installed on your system
- Maven or the provided Maven Wrapper (mvn or mvnw) available
- Git to clone the repository
Step-by-step:
-
Clone the repository: git clone <repository-url> && cd <repository-directory>
-
Build the project using the Maven wrapper (recommended): ./mvnw clean install
or if you prefer Maven directly:
mvn clean install
-
Run the Spring Boot application: ./mvnw spring-boot:run
or if you built the jar file, run:
java -jar target/*.jar
-
Verify the server is running by hitting the MCP endpoints (as documented in the Spring Boot MCP starter docs) or by checking logs for Spring Boot startup confirmation.
Notes:
- If you need a specific Spring profile, set SPRING_PROFILES_ACTIVE in your environment before starting the app.
- Ensure network access for any external APIs the MCP server may call.
Additional notes
Common issues and tips:
- If mvnw is not executable on Unix systems, run: chmod +x mvnw
- Ensure the target directory contains the built jar after a successful mvn clean install
- Check application.properties or application.yml for configuration overrides or endpoint paths
- For debugging, run with JAVA_OPTS or SPRING_PROFILES_ACTIVE to enable verbose logging or a development profile
- If you modify dependencies or Spring Boot versions, re-run the build to ensure all classes are recompiled
Related MCP Servers
reverse-engineering-assistant
MCP server for reverse engineering tasks in Ghidra 👩💻
quarkus-workshop-langchain4j
Quarkus Langchain4J Workshop
mcp-zap
A Spring Boot application exposing OWASP ZAP as an MCP (Model Context Protocol) server. It lets any MCP‑compatible AI agent (e.g., Claude Desktop, Cursor) orchestrate ZAP actions—spider, active scan, import OpenAPI specs, and generate reports.
glyph
🔮 glyph – mcp server to map your codebase with symbol outlines
mcp_mediator
Automatically generate an MCP Server from existing source code, service classes, helper methods, and external MCP tools. The MCP Mediator aggregates various sources and tools into a unified system, enabling seamless automatic generation of a complete MCP Server.
solon-ai-embedded-examples
solon ai(&mcp) embedded examples。支持 MCP_2025_06_18(mcp streamable)。示例项目包括各种框架嵌入:(Solon、SpringBoot、jFinal、Vert.X、Quarkus、Micronaut)