Docs import a namespace that does not exist: Mcp\Server\Capability\Attribute\McpTool
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
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de modelcontextprotocol/php-sdk
-
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStanAbertaServer
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 78/100
modelcontextprotocol/php-sdk#468 · 3 comentários ·
Mantenedores costumam responder em até 1 dia
-
enhancement P3
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 48/100
modelcontextprotocol/php-sdk#733 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
[Server] Handle notifications/cancelled on the handshake eraTalvez já em andamento @ump45nose assumiu há 5 dias. Abertahelp wanted improves spec compliance Server
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 57/100
modelcontextprotocol/php-sdk#732 ·
Mantenedores costumam responder em até 1 dia
-
[Client][Server] Ship extension classes for the two authorization extensionsTalvez já em andamento @chr-hertel assumiu há 6 dias. Abertaauth Client Server
modelcontextprotocol/php-sdk#721 · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[Client] Test cross-app access against a real identity providerTalvez já em andamento @chr-hertel assumiu há 6 dias. Abertaauth Client
modelcontextprotocol/php-sdk#720 · 1 responsável ·
Mantenedores costumam responder em até 1 dia
Todas as issues de modelcontextprotocol/php-sdk
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 82/100
pluginsGLPI/carbon#396 ·
-
[BUG] Bundle products lose their price in RSS feeds: getPrices() was removedTalvez já em andamento @pcvelz assumiu hoje. Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
OpenMage/magento-lts#5869 ·
Mantenedores costumam responder em até 2 dias
-
Map Info Window ButtonsAberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
OpenGIS/waymark-wp#82 ·
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
Mantenedores costumam responder em até 1 dia
-
claude
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
sprain/sprainocchio#39 ·
Mantenedores costumam responder em até 1 dia