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

Abierto
#757 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
47/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
php
Área
backend, cli

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
PHP
Estrellas
1.7k
Forks
206
Merge medio
1 d 19 h
PR fusionados (30 d)
100

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de modelcontextprotocol/php-sdk

Todos los issues de modelcontextprotocol/php-sdk

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.