Spring MCP Server について
Spring AI v1.0.0 で構築された MCP サーバープロジェクトです。Spring AI と MCP プロトコルを調べる開発者向けで、チャットサーバーと MCP ツールリクエスト用ツールも含みます。
主な機能
- 01Spring AI ベースの MCP サーバー
- 02チャットサーバーモジュール
- 03MCP ツールリクエスト用ツール
- 04SSE と stdio のテストモード
活用シーン
- 01MCP サーバーのテスト実行
- 02MCP ツールリクエストの調査
- 03フォーマットとビルド成果物の確認
MCP 対応
Spring AI 製の MCP サーバーと、MCP ツールリクエストを行うツールが含まれます。SSE と stdio のテスト実行コマンドが用意されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Spring MCP Server
Spring AI v1.0.0 を使用しています
リポジトリ
- mcp-server
- Spring AI を使用して構築された MCP サーバー
- chat-server
- Spring AI を使用して構築されたチャットサーバー
- mcp-tool
- プロトコルの理解に役立つ、MCP ツールリクエストを実行するツール
セットアップ
Ubuntu のセットアップ
Ubuntu を使用している場合は、必要なパッケージをインストールしてください。
sudo apt-get update
sudo apt-get install -y openjdk-21-jdk gradle locales
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
Java 21 がデフォルトの JDK として設定されていることを確認し、プロジェクトディレクトリから gradle コマンドを直接実行してください。
Gradle の基本コマンド
gradle test
gradle :mcp-app:bootJar
gradle :mcp-server:runMcpTestSse
gradle :mcp-server:runMcpTestStdio
gradle spotlessCheck # verify formatting
gradle spotlessApply # automatically format sources
設定
mcp-server モジュールは tool-context.home プロパティを読み込み、ToolContextService から返される環境情報を設定します。デフォルトの application.yml では、このプロパティを TOOL_CONTEXT_HOME 環境変数に割り当て、設定されていない場合は HOME を使用します。
tool-context:
home: ${TOOL_CONTEXT_HOME:${HOME}}
Spring の設定を使用するか、サーバーの実行時に TOOL_CONTEXT_HOME 変数をエクスポートすることで、この値を上書きできます。
ライセンス
このプロジェクトは MIT License のライセンスで公開されています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。