Spring MCP Server Demo

Name: Spring MCP Server Demo
Author: esurovtsev

@esurovtsev

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

基本情報

カテゴリ

その他

ランタイム

java

トランスポート

stdio

公開者

esurovtsev

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.