mcpField
S
simple-mcp-server

simple-mcp-server

Local
github.com/marcelloraffaeleDeveloper Tools0Updated 81w ago
Repository

About simple-mcp-server

A Java Spring Boot MCP server with services for personalized greetings and number operations. It is intended for setups that expose these functions to MCP clients.

Key features

  1. 01Generate personalized greetings
  2. 02Perform number operations
  3. 03Generate random numbers
  4. 04Run locally or with Docker

Use cases

  1. 01Create tailored greetings for an application
  2. 02Perform number operations from an MCP client
  3. 03Launch the MCP server with Docker

MCP support

The project implements an MCP server that can be configured over stdio for MCP clients, exposing greeting and number services.

#simple-mcp-server#java#spring-boot

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "simple-mcp-server-marcelloraffaele": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

simple-mcp-server

Java Spring Boot simple MCP server implementation

Description

The simple-mcp-server project includes two core services:

  1. GreetingsService: This service is responsible for generating personalized greeting messages. It provides functionality to create dynamic and user-specific greetings based on input parameters.

  2. NumberService: This service handles operations related to numbers, such as performing arithmetic calculations or generating random numbers. It is designed to support various numerical operations efficiently.

Run it using the Docker image

Modify the mcp.server configuration

{
    "servers": {
        "simple-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/marcelloraffaele/simple-mcp-server:main"
            ]
        }
        
    }
}

Run it locally

  1. Build the project
mvn clean install
  1. Run the server Change the mcp.server configuration adding the following:

        "simple-mcp-server": {
            "type": "stdio",
            "command": "java",
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-jar",
                "C:\\Workspaces\\......\\simple-mcp-server\target\\simple-mcp-server-0.0.1-SNAPSHOT.jar"
            ]
        }

Run the server with Docker

  1. Build the project
mvn clean install
docker build -t simplemcpserver:1.0 .
  1. Run the server Change the mcp.server configuration adding the following:
        "simple-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "simplemcpserver:1.0"
            ]
        }

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.