Springboot MCPserver JUnit

🚀 Springboot + MCP + JUnit プロジェクトテンプレート

Springbootを使用してMCPプロジェクトを迅速に構築します。このプロジェクトはJUNITユニットテストをサポートしています。 サポートされるモード：STDIO と SSE

解説動画：

• 全国初公開：ゼロからSpringboot+MCP+JUnitプロジェクトを構築する 【CherryStudioとセット】BV1qUXkYRE6C
• 全国初公開：Springboot+MCP(SSE)+JUnitの構築から本番環境へのデプロイまで BV1rSXWYGEVz

🚀 クイックスタート

開発環境

• 開発IDE: IDEA
• Javaバージョン: JAVA17 (Spring公式ではJava17以上が必須とされています)
• Mavenバージョン: 3.8.1 (バージョンが高すぎるとプロジェクトをインポートする際にエラーが発生する可能性がありますので、適切なバージョンを選択してください)

参考ドキュメント

1. MCP公式サイト - プロトコル (必読ドキュメント)
2. MCP公式サイト - コーディングガイド
3. Spring公式サイト

クライアントテスト方法

1. STDIOクライアントの設定方法

コマンド(Command):
    java
パラメータ(Arguments):
    -jar
    -Dfile.encoding=UTF-8
    -Dspring.ai.mcp.server.stdio=true
    AbsolutePath/**/xxx.jar
環境変数(Environments):
    env1=xxx
    env2=yyy

コマンドはjavaです（ローカルのメイン環境がJava17以上でない場合は、切り替えることに注意してください）。 パラメータfile.encodingは、System.inとSystem.outをUTF-8エンコーディングに指定し、エンコーディングの問題を回避します。 パラメータspring.ai.mcp.server.stdioは、stdio方式でサービスを起動することを示します。 環境変数の設定は、現在のシステム環境に設定を書き込み、現在のプログラムが呼び出せるようにします。

2. SSEクライアントの設定方法

SSEアドレスには以下のリンクを入力してください：
http://ホストアドレス:ポート/sse

追加のオプション機能の探索

1. メッセージエンドポイントの変更

設定ファイルはMcpServerPropertiesを参照してください。

spring.ai.mcp.server.sseMessageEndpoint=/mcp/message

2. SSEエンドポイントの変更

元のSSEエンドポイントは/sseで、設定ファイルにSSEエンドポイントの設定方法が提供されていないため、ServerMcpTransport を再注入して元のものを置き換える必要があります。

以下の2つのBean設定を追加することに注意してください。自動注入ファイル MpcWebMvcServerAutoConfiguration では、登録全体の注入条件が@ConditionalOnMissingBean(ServerMcpTransport.class)であるため、以下の2つのbeanが注入されなくなります。

private final String SSE_ENDPOINT = "/sse";

@Bean
@ConditionalOnMissingBean
public WebMvcSseServerTransport webMvcSseServerTransport(ObjectMapper objectMapper,
        McpServerProperties serverProperties) {
    return new WebMvcSseServerTransport(objectMapper, serverProperties.getSseMessageEndpoint(), SSE_ENDPOINT);
}

@Bean
public RouterFunction<ServerResponse> mvcMcpRouterFunction(WebMvcSseServerTransport transport) {
    return transport.getRouterFunction();
}

3. 1つのサービスに複数のエンドポイントを設定するには？

複数の McpSyncServer を再注入する必要があります。詳細はクラス MpcServerAutoConfiguration を参照してください。

複数のエンドポイントを設定すると、多くのことが関係する可能性があります。興味がある方は自分で研究してみてください。ここではこのようなガイドのみを提供します！

4. SSEの認証？

2025.03.26のMCP公式プロトコルドキュメントで、認証方式が更新されました。 Springの更新を期待しています。