Docs import a namespace that does not exist: Mcp\Server\Capability\Attribute\McpTool

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

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
1/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
85/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
php
Domínio
documentation

Direção de pesquisa

Atualize as importações em docs/get-started/first-server.md e README.md; comece verificando os exemplos existentes em relação aos namespaces de atributos da v0.9.0 listados na issue. O trabalho estará concluído quando os dois exemplos importarem os atributos de Mcp\Capability\Attribute\ para corresponder ao SDK. O class_alias sugerido é opcional e exigiria uma revisão de escopo separada.

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

Descrição

What's wrong

The getting-started docs and the SDK README both tell you to import the tool attribute from a namespace that does not exist in v0.9.0.

docs/get-started/first-server.md:

use Mcp\Server\Capability\Attribute\McpResource;
use Mcp\Server\Capability\Attribute\McpTool;

README.md shows the same import.

What actually exists

Verified against mcp/sdk v0.9.0:

use Mcp\Capability\Attribute\McpTool;         // correct
use Mcp\Capability\Attribute\McpResource;     // correct
use Mcp\Capability\Attribute\McpPrompt;       // correct
use Mcp\Capability\Attribute\McpResourceTemplate; // correct
$ ls vendor/mcp/sdk/src/Server/Capability
ls: vendor/mcp/sdk/src/Server/Capability: No such file or directory

$ php -r 'require "vendor/autoload.php";
  var_dump(class_exists("Mcp\Server\Capability\Attribute\McpTool"));
  var_dump(class_exists("Mcp\Capability\Attribute\McpTool"));'
bool(false)
bool(true)

All five attribute classes live under Mcp\Capability\Attribute\. The Server\ segment was dropped at some point, and the docs were not updated with it.

Why it's worth fixing

Copying the quickstart verbatim is a fatal error on the very first file a new user writes. The error points at the use statement, so it reads like a typo the user made rather than an outdated doc, and the natural next step is to go looking for a typo instead of checking the installed version.

Suggested fix

Update the quickstart and README imports. If the flattening is recent, a class_alias shim for one release would let code written against the old docs keep working:

class_alias(\Mcp\Capability\Attribute\McpTool::class, \Mcp\Server\Capability\Attribute\McpTool::class);

Happy to open a PR for the docs if that's easier than doing it yourself.


Found while building a hackathon project against mcp/sdk v0.9.0 / symfony/mcp-bundle v1.0.0-BETA1 on PHP 8.5.8.

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

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.