modelcontextprotocol / modelcontextprotocol/java-sdk
Initialization errors in McpAsyncClient not emitted immediately
まだ誰も着手していません。
- 主要言語
- Java
- スター
- 3.7k
- フォーク
- 1.1k
- 平均マージ
- 1日 15時間
- マージ済み PR(30日)
- 9
説明
Bug Description
When subscribing to exceptions from McpAsyncClient.initialize() using onErrorResumein order to catch initialization failures immediately, nothing is emitted. I suspect this is caused by McpAsyncClient not propagating errors downstream.
I’m new to Reactor and don’t know how to fix this. Any simple tips or pointers, like which class or method handles error propagation, would be really helpful so I can send a PR.
Also, I believe this issue may be related to:
- https://github.com/modelcontextprotocol/java-sdk/issues/275
- https://github.com/modelcontextprotocol/java-sdk/issues/377
- https://github.com/modelcontextprotocol/java-sdk/issues/151
Environment
JDK: zulu-21
gradle: 8.10.2
IntelliJ IDEA 2025.1.1.1 (Community Edition) (K2 mode)
io.modelcontextprotocol java-sdk commit: https://github.com/modelcontextprotocol/java-sdk/commit/8a2f97f1b1995880c492159dd1b4c50266d0b579
Steps to reproduce
- Clone and
installthe repo, checkout https://github.com/modelcontextprotocol/java-sdk/commit/8a2f97f1b1995880c492159dd1b4c50266d0b579 - Run the script provided below
- Observe that no immediate exception is thrown
Expected behavior
- When I initialize McpClient with an incorrect transport
- And internally, the
reactor.core.publisher.Operatorslogger reports:
java.lang.RuntimeException: Failed to start process with command: [a, a] - Then I expect the initialization to fail immediately - not after my configured timeout
Minimal Complete Reproducible example
Main.kt:
import io.modelcontextprotocol.client.transport.StdioClientTransport
import io.modelcontextprotocol.client.transport.ServerParameters
import kotlinx.coroutines.reactive.awaitSingle
import mu.KotlinLogging
import reactor.core.publisher.Mono
import java.time.Duration
private val logger = KotlinLogging.logger {}
suspend fun main() {
val params = ServerParameters.builder("a").args("b").build()
val transport = StdioClientTransport(params)
val client = io.modelcontextprotocol.client.McpClient
.async(transport)
.requestTimeout(Duration.ofSeconds(6))
.initializationTimeout(Duration.ofSeconds(5))
.build()
client.initialize()
.doOnError { t -> logger.error { t }; return@doOnError }
.onErrorResume { return@onErrorResume Mono.error(it) }
.awaitSingle()
}
build.gradle.kts:
plugins {
kotlin("jvm") version "2.1.20"
}
group = "com.anything.mcp"
version = "1.0-SNAPSHOT"
repositories {
mavenLocal()
mavenCentral()
}
dependencies {
implementation("io.modelcontextprotocol.sdk:mcp:0.11.0-SNAPSHOT")
implementation("io.modelcontextprotocol.sdk:mcp-spring-webflux:0.11.0-SNAPSHOT")
implementation("io.github.microutils:kotlin-logging:3.0.5")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-reactor:1.8.0")
}
kotlin {
jvmToolchain(21)
}
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず、Main.ktで使用されているMcpAsyncClient.initialize()とStdioClientTransportの起動経路を追跡し、プロセス起動時の失敗がどのようにReactorのpublisherに到達するかを確認します。提供された再現手順とOperatorsのロガー出力を使って、失敗がinitializationTimeoutの後でないと発生しないのではなく、直ちに通知されることを確認してください。完了条件は、タイムアウトを待たずにエラーがdoOnError/onErrorResumeに到達することです。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- java, kotlin
- 領域
- api, backend
- issue の種類
- バグ
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 活発さ
- 静か
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 48/100