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

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.

Frequently asked questions

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

Basic information

Category

Other

Transports

stdio

Author

esurovtsev

More Other MCP servers

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K