[Client] StdioTransport hangs after successful initialize on Windows (fwrite EINVAL on the second request)
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 47/100
Piste de recherche
Start with the client-side Mcp\Client\Transport\StdioTransport write path and how it handles child stdin on Windows; the issue provides a minimal client and server repro. Run the repro on Windows and trace why the second request fails with fwrite EINVAL while the first succeeds. Done means listTools() returns the advertised tool or fails promptly with a catchable exception.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Environment
- OS: Windows 11 (10.0.26200), x64
- PHP: 8.4.27 (CLI, NTS)
- mcp/sdk: 0.9.0
- Server: built with the same SDK (0.9.0), served over
Mcp\Server\Transport\StdioTransport - Triggered both directly via
Mcp\Client\Builderand throughsymfony/mcp-bundle1.0.0-BETA1
Description
On Windows, the client-side Mcp\Client\Transport\StdioTransport hangs after a successful
initialize handshake. The first request (initialize/discover) is written and answered fine; the
second request (tools/list) fails to write to the child's stdin and the call never returns.
Observed directly with the SDK client:
[info] Protocol connected to transport {"transport":"Mcp\\Client\\Transport\\StdioTransport"}
[info] Started MCP server process {"command":"php \"...\""}
[debug] Sending request {"id":1,"method":"server\/discover"}
[debug] Sent message to server {...}
[debug] Suspending fiber for response {"id":1}
[info] Client connected and initialized ← handshake OK
[debug] Sending request ← tools/list
[debug] Notice: fwrite(): Write of 270 bytes failed with errno=22 Invalid argument
[error] Failed to list the tools of MCP server "coroner", it contributes none for the next 60 seconds.
php client.php (repro below) then hangs indefinitely (> 5 minutes, no return, no exception —
had to kill the process). conn->listTools() never comes back.
Minimal repro
composer.json:
{
"require": {
"mcp/sdk": "^0.9.0",
"symfony/finder": "^8.0",
"psr/log": "^3.0"
}
}
server.php — a one-tool server, same SDK:
<?php
require __DIR__.'/vendor/autoload.php';
use Mcp\Server;
use Mcp\Server\Capability\Attribute\McpTool;
use Mcp\Server\Transport\StdioTransport;
class PingTools
{
#[McpTool(name: 'ping', description: 'Returns pong')]
public function ping(): string
{
return 'pong';
}
}
exit(
\Mcp\Server::builder()
->setServerInfo('ping-server', '0.0.1')
->setDiscovery(__DIR__, ['.'], excludeDirs: ['vendor'])
->build()
->run(new StdioTransport())
);
client.php:
<?php
require __DIR__.'/vendor/autoload.php';
use Mcp\Client\Builder;
use Mcp\Client\Transport\StdioTransport;
$client = (new Builder())->build();
$conn = $client->connect(new StdioTransport(
command: 'php',
args: [__DIR__.'/server.php'],
cwd: __DIR__,
));
$tools = $conn->listTools(); // ← hangs here on Windows
echo 'TOOLS: '.count($tools)."\n";
$result = $conn->callTool('ping', []);
echo 'ping: '.json_encode($result->content)."\n";
$client->disconnect();
php client.php → prints nothing after connect, hangs forever.
What I ruled out
- Not the protocol era: pinning the client to
2025-11-25changes nothing; the same failure
happens when the client negotiates the modern era (2026-07-28). - Not the server: the same server process responds correctly to a hand-rolled
proc_openclient (write JSON lines, blockingfgets) — initialize,notifications/initialized,
tools/list,tools/callall work, repeatedly, over many writes. - Not HTTP: the same server exposed over the bundle's HTTP transport works flawlessly with
the SDK's HTTP client.
Two additional observations that may help:
- The failing write is always the second one; the first (initialize/discover) succeeds.
- When the parent process is started from Git Bash, the spawned child additionally fails to
resolvephpat all ('php' is not recognized as an internal or external commandin the
child's stderr — POSIX-stylePATHnot survivingproc_openon Windows), which surfaces as
connection retries. That one is likely an environment quirk rather than an SDK bug, but it
makes the client's failure mode hard to diagnose: the child's stderr only shows up at debug
log level, while the user-facing error is a generic "Failed to list the tools …".
Expected behavior
listTools() returns the advertised tools on Windows, exactly like on Linux/macOS — or at the
very least fails fast with a catchable exception instead of hanging.
Workaround we ship
Serve over HTTP instead of STDIO for the bundled client (works perfectly on Windows):
transports: { http: true } + client transport: http.
- Langage dominant
- PHP
- Étoiles
- 1.7k
- Forks
- 206
- Merge moyen
- 1 j 19 h
- PR mergées (30 j)
- 100
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de modelcontextprotocol/php-sdk
-
[Client] `Builder::addRequestHandler()` rejects the SDK's own handlers under PHPStanPeut-être pris @xixi-box l’a pris aujourd’hui. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
modelcontextprotocol/php-sdk#768 ·
Les mainteneurs répondent en général sous 1 jour
-
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStanOuverteServer
Difficulté 1/5 Moins d'une heure Accessibilité débutants 78/100
modelcontextprotocol/php-sdk#468 · 3 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
[Client] `callTool()` cannot defer `input_required` or send a later retry (MRTR)Peut-être pris @xixi-box l’a pris aujourd’hui. Ouverte
Difficulté 4/5 3-5 jours Accessibilité débutants 30/100
modelcontextprotocol/php-sdk#767 ·
Les mainteneurs répondent en général sous 1 jour
-
[Server] Answer arguments the input schema refuses with an `isError` result from revision 2025-11-25 onPeut-être pris @falisco l’a pris aujourd’hui. Ouverte
Difficulté 3/5 1-2 jours Accessibilité débutants 25/100
modelcontextprotocol/php-sdk#763 ·
Les mainteneurs répondent en général sous 1 jour
-
[Server] A `float $x = INF` default makes `tools/list` fail for all toolsPeut-être pris @andre-schade l’a pris il y a 2 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 25/100
modelcontextprotocol/php-sdk#756 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de modelcontextprotocol/php-sdk
Issues similaires
-
Change: check an identifier filter the same way in every tool - the order of somcp_search_ordersOuverteconsistency enhancement Orders
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
novalo-dev/Prestashop-MCP-Server#343 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
claude
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
sprain/sprainocchio#45 ·
Les mainteneurs répondent en général sous 1 jour
-
sync-en
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
-
sync-en
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour