MCP Sample Java Application について
Spring AI で MCP サーバーを実装する、最小構成の Spring Boot アプリケーションです。MCP クライアントに接続する外部 Java サーバーが必要な開発者向けです。
主な機能
- 01Spring Boot ベースの MCP サーバー
- 02Spring AI との連携
- 03Maven によるパッケージ化
- 04Java 21 が必要
活用シーン
- 01クライアント向け外部 MCP サーバーの実行
- 02Java MCP サーバーのサンプル作成
MCP 対応
Spring AI の MCP server WebMVC starter を使って MCP サーバーを実装します。MCP クライアント向けの外部サーバーとして設定できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP サンプル Java アプリケーション
これは、Spring AI を使用して MCP(Model Controller Provider)サーバーを実装する最小限の Spring Boot アプリケーションです。
クライアントアプリケーション用の外部 MCP サーバーとして利用できるように設計されています。
🚀 はじめに
1. プロジェクトをクローンする
git clone [email protected]:Saularch97/mcp-java-sample.git
cd openmeteomcp
2. プロジェクトをビルドする
mvn clean package
出力先は target/openmeteomcp-0.0.1-SNAPSHOT.jar です。
⚙️ クライアントの設定
クライアントからサーバーを実行するには、次の設定を挿入してください。
{
"mcpServers": {
"mcpopenmeteo": {
"command": "java",
"args": [
"-jar",
"<PATH_TO_YOUR_PROJECT>/openmeteomcp/target/openmeteomcp-0.0.1-SNAPSHOT.jar",
"--port",
"8080",
"--host",
"localhost"
]
}
}
}
<PATH_TO_YOUR_PROJECT> は、プロジェクトディレクトリの実際のパスに置き換えてください。
📦 プロジェクトの依存関係
このプロジェクトは、次の Spring AI スターターモジュールに依存しています。
<dependencies>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
</dependency>
</dependencies>
🧰 要件
- Java 21
- Maven 3.8+
このプロジェクトを使用するには、Cursor、ClaudeDesktop、Vscode などのクライアントに接続してください。

コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。