Spring MCP Server Demo

Spring MCP Server Demo

Spring Boot と Java を使用してリモート Model Context Protocol（MCP）サーバーを構築する方法を紹介する、シンプルなデモです。このプロジェクトでは、MCP プロトコルを介して AI モデルから呼び出せるツールを実装し、公開する方法を紹介します。

内容

• Spring AI を使用した MCP サーバーの完全な実装
• ツールの登録とコールバック処理
• 実用的なツールの例としての RAG 検索サービス
• 簡単にデプロイできる Docker サポート

クイックスタート

# Run with Maven
mvn spring-boot:run

# Or build and run the JAR
mvn clean package
java -jar target/mcpserver-0.0.1-SNAPSHOT.jar

サーバーは http://localhost:8080 で起動します。

🧪 MCP Inspector でのテスト

MCP Inspector は、LLM と連携せずに MCP サーバーをテストできるツールです。

# Run the Inspector with your MCP server
npx @modelcontextprotocol/inspector

MCP Inspector のウェブインターフェイスが起動します（通常は http://127.0.0.1:6274）。

Docker サポート

Docker で実行したい場合も、問題ありません！

# Build and package everything in one go
./docker-build.sh

# Run the container
docker run -p 8080:8080 mcp-server:latest

これで完了です！MCP サーバーは http://localhost:8080 で利用できます。

利用可能なツール

検索

RAG ディレクトリ内のドキュメントファイルを検索します。

パラメーター：

• query：検索語

戻り値： ドキュメントから見つかった、関連性の高いテキストスニペットのリスト

仕組み

このデモでは Spring AI の MCP サーバー機能を使って、AI モデルから呼び出せるツールを公開しています。サーバーは Model Context Protocol を実装しており、AI モデルがこのサーバーの提供するツールを検出して利用できます。

RAG 検索ツールでは、特定の情報源へのアクセスを提供し、AI モデルの機能を強化する実用的なツールの実装方法を紹介しています。