[Client] `Builder::addRequestHandler()` rejects the SDK's own handlers under PHPStan

Aberta Para iniciantes
#768 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@xixi-box já está trabalhando nisso.

Desde 22/11/2026.

  • #770 de @xixi-box — aberto

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
68/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
php

Direção de pesquisa

Leia src/Client/Builder.php:177-179 para a assinatura de addRequestHandler() e src/Client/Handler/Request/RequestHandlerInterface.php:21 para a declaração @template que torna o parâmetro invariante. Reproduza o problema executando o PHPStan no nível máximo contra um trecho parecido com o da issue e, em seguida, marque o template como @template-covariant ou altere o parâmetro para RequestHandlerInterface<*>. Está concluído quando o PHPStan aceita os handlers próprios do SDK, como ElicitationRequestHandler, e os testes existentes continuam passando.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Package: mcp/sdk 0.9.0; still present in v0.10.0 and main (src/Client/Builder.php:177-179,
src/Client/Handler/Request/RequestHandlerInterface.php:21)

Client::builder()->addRequestHandler(new ElicitationRequestHandler($callback));

Actual (PHPStan level max): Parameter #1 expects RequestHandlerInterface<mixed>, ElicitationRequestHandler given;
the template parameter is invariant.

Expected: accepted: declare the template covariant (@template-covariant) or type the parameter
RequestHandlerInterface<*>.

Found while building Leash for the Symfony AI & PHP MCP SDK hackathon.

Linguagem predominante
PHP
Estrelas
1.7k
Forks
206
Merge médio
1d 19h
PRs com merge (30d)
100

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de modelcontextprotocol/php-sdk

Todas as issues de modelcontextprotocol/php-sdk

Issues semelhantes

Mais issues de PHP

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.