MCP Server Spring Java

🚀 MCP Server Implemented with Spring Boot and Java

This is an MCP (Model Context Protocol) server implemented using Spring Boot and Java 21, demonstrating how to create an MCP server that provides user management tools for AI assistants.

🚀 Quick Start

Prerequisites

• Java 21 or higher
• Maven

Installation

1. Clone the repository

git clone https://github.com/yourusername/mcp-spring-java.git
cd mcp-spring-java

2. Build the project

mvn clean package

3. Run the application

java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar

✨ Features

• Implement MCP server functionality using Spring AI.
• Provide user management tools through the MCP interface.
• Support synchronous communication mode.
• Support standard I/O and Server-Sent Events (SSE) transmission.
• Integrate with the DummyJSON external API for user data interaction.

🔧 Technical Details

• Java 21
• Spring Boot 3.4.3
• Spring AI (Model Context Protocol)
• Project Lombok
• Maven

📚 Documentation

Configuration

The MCP server is configured in application.yml:

• The server runs on port 8090.
• Server name: my-dummy-users-server.
• Synchronous communication mode.
• Support terminal-based communication using standard I/O.
• Provide the /mcp/message endpoint for SSE communication.

Available Tools

The server exposes the following user management tools:

• getAllUsers - Get all users (with pagination).
• getAllUsersDefault - Get all users (default pagination).
• getUserById - Get a single user by ID.
• searchUsers - Search for users (based on query criteria).
• addUser - Add a new user.
• updateUser - Update user information.
• deleteUser - Delete a user.

Testing with Postman

You can use Postman to test the MCP server endpoints:

1. Start the MCP server.
2. Open Postman and create a new request:
   • Method: POST
   • URL: http://localhost:8090/mcp/message
   • Request headers:
     • Content-Type: application/json
     • Accept: application/json
3. For the request body, use the following JSON format to call any available tool:

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "[TOOL_NAME]",
        "parameters": {
          "[PARAMETER_NAME]": "[PARAMETER_VALUE]"
        }
      }
    ]
  }
}

Example Requests

Get All Users (Default Pagination)

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getAllUsersDefault",
        "parameters": {}
      }
    ]
  }
}

Get User by ID

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getUserById",
        "parameters": {
          "id": 1
        }
      }
    ]
  }
}

Search Users

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "searchUsers",
        "parameters": {
          "query": "example"
        }
      }
    ]
  }
}

📄 License

This project is licensed under the Apache License 2.0.