MCP Greeting Server

A Model Context Protocol (MCP) server that provides greeting functionality, built with Java 25, Gradle, and Spring AI.

Overview

This server implements the Model Context Protocol to provide greeting-related tools and resources. It can be integrated with MCP-compatible clients to add greeting capabilities to AI assistants.

Installation

From MCP Registry

This server is published on the MCP Registry and can be installed directly:

Using Docker:

{
  "mcpServers": {
    "greeting": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yotamfreund-eng/mcp-greeting-server:latest"]
    }
  }
}

Add this to your Claude Desktop configuration file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

From Source

# Build (Windows)
gradlew.bat build

# Run
gradlew.bat bootRun

# Or use convenience scripts
scripts\build.bat
scripts\start.bat

Features

• Tools: Expose greeting functions that can be called by AI assistants
• Resources: Provide greeting templates and patterns
• Prompts: Pre-configured greeting prompts for various scenarios
• Built with Spring AI for enhanced AI capabilities
• Containerized deployment support

Technology Stack

• Java: OpenJDK 25
• Build Tool: Gradle 9.2.1
• Framework: Spring Boot 3.5.7
• Spring AI: 1.1.2 with MCP server support
• Protocol: Model Context Protocol (MCP)

Prerequisites

• Java 25 (OpenJDK)
• Gradle 9.2.1 or higher

Installation

Clone the repository:

git clone https://github.com/yourusername/mcp-greeting-server.git
cd mcp-greeting-server

Building

Build the project using Gradle:

./gradlew build

For Windows:

gradlew.bat build

Note: If you have multiple Java versions installed, run scripts\set-java-25.bat first on Windows to ensure Java 25 takes priority.

Building Docker/OCI Images

The server can be packaged as a Docker/OCI container image for deployment to the MCP registry or container platforms.

Quick Start

# Build Docker image with full MCP registry labels
scripts\build-image.bat

Or using Gradle directly:

gradlew.bat buildDockerImage

This uses the Dockerfile and includes all MCP registry metadata labels:

• mcp.protocol.version
• mcp.server.name
• mcp.server.version
• mcp.transport

Running the Container

Run with STDIO transport (MCP registry standard):

docker run -i --rm mcp-greeting-server:latest

The --rm flag automatically removes the container when it stops (recommended for most use cases).

Run with HTTP/SSE transport:

docker run -p 8080:8080 -e SPRING_PROFILES_ACTIVE=d

... [View full README on GitHub](https://github.com/yotamfreund-eng/mcp-greeting-server#readme)