Dummy User

Provides a Spring Boot MCP server exposing user management tools for AI assistants via STDIO and SSE transports.

other

4

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mtwn105-mcp-server-spring-java": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "target/mcp-spring-java-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

You can run an MCP server built with Spring Boot that exposes user management tools for AI assistants. It supports synchronous communication and transports via standard I/O and Server-Sent Events, letting you manage users through a consistent MCP interface.

How to use

You connect to the MCP server from an MCP client and call the built‑in user management tools. Each tool performs a specific action such as listing users, fetching a user by ID, searching users, or creating, updating, and deleting users. Use the available tool names to perform tasks, and provide the necessary parameters your query requires. The server handles the request and returns the results, allowing you to work with user data in a structured, predictable way. If you are using a terminal or a client that supports Server-Sent Events, you can subscribe to ongoing messages and receive updates as operations complete.

How to install

Prerequisites:
- Java 21 or higher
- Maven

Steps to run:
1. git clone https://github.com/yourusername/mcp-spring-java.git
2. cd mcp-spring-java
3. mvn clean package
4. java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar

Additional configuration and notes

Configuration is defined to run the MCP server with an explicit setup for synchronous communication and STDIO transport. The server binds on port 8090, uses the name my-dummy-users-server, and exposes the /mcp/message endpoint for SSE communication. You can adjust these settings to fit your environment by following the configuration options described in the server setup.

Testing and usage can be performed by starting the server and connecting with an MCP client. The server exposes a set of user management tools that you can invoke from your client with the appropriate tool name and parameters. If you want to run the server from a script or within a container, ensure you pass the same Java runtime arguments used during development to enable STDIO mode.

MCP tooling and environment

The server is designed for Java 21 with Spring Boot 3.4.3 and uses MCP tooling to expose user management actions. When you configure a client, you typically reference the same runtime command used to start the server locally, ensuring the STDIO mode is enabled so the client can communicate via the MCP channel.

Available tools

getAllUsers

Retrieves all users with support for pagination to limit the number of results returned in a single call.

getAllUsersDefault

Fetches all users using the default pagination settings configured on the server.

getUserById

Retrieves a single user by their unique identifier.

searchUsers

Searches for users that match a query string, returning matching results.

addUser

Adds a new user to the data store with the provided user details.

updateUser

Updates the information for an existing user.

deleteUser

Removes a user from the data store by their identifier.