MCP Server using Spring Boot Java

What is MCP Server using Spring Boot Java?

A Model Context Protocol (MCP) server built with Spring Boot and Java 21, exposing user management tools for AI assistants. It integrates with the DummyJSON external API to provide CRUD operations on user data.

How to use MCP Server using Spring Boot Java?

Build the project with mvn clean package, then run the jar with java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar. The server supports both STDIO and SSE transports; configure it in application.yml (default port 8090) or via command-line flags. Test tools by sending POST requests to /mcp/message with a JSON payload specifying the tool name and parameters. For use with MCP clients, add a configuration entry pointing to the jar with -Dspring.ai.mcp.server.stdio=true.

Key features of MCP Server using Spring Boot Java

• Implements MCP server using Spring AI
• Exposes seven user management tools (CRUD + search)
• Supports Standard I/O and Server-Sent Events transports
• Synchronous communication mode
• Integrates with DummyJSON external API
• Built with Java 21 and Spring Boot 3.4.3

Use cases of MCP Server using Spring Boot Java

• AI assistants retrieving paginated user lists from an external API
• Fetching a specific user by ID to answer user queries
• Searching users by name or keyword via the searchUsers tool
• Creating, updating, or deleting user records through chat interactions

FAQ from MCP Server using Spring Boot Java

What tools does MCP Server using Spring Boot Java expose?

It provides seven tools: getAllUsers, getAllUsersDefault, getUserById, searchUsers, addUser, updateUser, and deleteUser.

How can I test the server without an MCP client?

Use Postman to send a POST request to http://localhost:8090/mcp/message with a JSON body containing the tool call. Example: {"message":{"toolCalls":[{"id":"call-123","name":"getUserById","parameters":{"id":1}}]}}.

What are the runtime dependencies?

Java 21 or higher and Maven are required to build and run the application. The project uses Lombok, Spring AI, and the DummyJSON API (external).

Which transports does it support?

Standard I/O (STDIO) for terminal‑based communication and Server‑Sent Events (SSE) via the /mcp/message endpoint.

Where does the user data come from?

All user data is fetched from the DummyJSON external API; no local database is used.