MCP.so
Sign In

Spring MCP Server Demo

@esurovtsev

Repository

About Spring MCP Server Demo

Remote MCP (Model Context Protocol) server built with Spring Boot and SSE. Demonstrates how to register tools, configure endpoints, and stream results to connected LLM clients using the Spring AI MCP SDK.

#spring-mcp#mcp-server#spring-boot

Basic information

Category

Other

Runtime

java

Transports

stdio

Publisher

esurovtsev

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "spring-mcp-remote-sse": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Spring MCP Server Demo?

A demonstration project that shows how to build a remote Model Context Protocol (MCP) server using Spring Boot and Java. It implements and exposes tools that AI models can call through the MCP protocol, with a RAG search service as a practical example.

How to use Spring MCP Server Demo?

Run with mvn spring-boot:run or build the JAR (mvn clean package) and execute it. The server starts at http://localhost:8080. Test it using the MCP Inspector by running npx @modelcontextprotocol/inspector. Docker deployment is also available via the provided docker-build.sh script.

Key features of Spring MCP Server Demo

  • Provides a complete MCP server implementation using Spring AI.
  • Includes tool registration and callback handling.
  • Offers a RAG search tool that searches documentation files.
  • Supports deployment with Docker.

Use cases of Spring MCP Server Demo

  • Learning how to build a remote MCP server with Spring Boot.
  • Demonstrating tool exposure for AI model integration.
  • Prototyping a search service that retrieves relevant text snippets from documentation.
  • Testing MCP server functionality without an LLM using MCP Inspector.

FAQ from Spring MCP Server Demo

What is the purpose of this server?

It demonstrates how to build a remote MCP server using Spring Boot and Java, showcasing tool registration and callback handling.

How do I run the server?

Use mvn spring-boot:run or build the JAR and run java -jar target/mcpserver-0.0.1-SNAPSHOT.jar. The server starts at http://localhost:8080.

What tools are available?

The server exposes a Search tool that takes a query parameter and returns a list of relevant text snippets from the RAG documentation directory.

How can I test the server without an LLM?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector. It provides a web interface (typically at http://127.0.0.1:6274) to test your MCP server.

Does the server support Docker?

Yes. Run ./docker-build.sh to build the image, then docker run -p 8080:8080 mcp-server:latest to start the container.

Comments

More Other MCP servers

Core Philosophy: Connect, Unify, Respond

mindsdb

Delegate anything. It comes back done.

39.4K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

ICSS

chokcoco

不止于 CSS

20.7K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K