[Client] StdioTransport hangs after successful initialize on Windows (fwrite EINVAL on the second request)

Ouverte
#757 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

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
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
php
Domaine
backend, cli

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\Builder and through symfony/mcp-bundle 1.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-25 changes 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_open client (write JSON lines, blocking fgets) — initialize, notifications/initialized,
    tools/list, tools/call all 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:

  1. The failing write is always the second one; the first (initialize/discover) succeeds.
  2. When the parent process is started from Git Bash, the spawned child additionally fails to
    resolve php at all ('php' is not recognized as an internal or external command in the
    child's stderr — POSIX-style PATH not surviving proc_open on 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

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de modelcontextprotocol/php-sdk

Toutes les issues de modelcontextprotocol/php-sdk

Issues similaires

Plus d'issues PHP

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.