Docs import a namespace that does not exist: Mcp\Server\Capability\Attribute\McpTool
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 1/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 85/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- php
- Domaine
- documentation
Piste de recherche
Mettez à jour les imports dans docs/get-started/first-server.md et README.md ; commencez par vérifier les exemples existants à partir des espaces de noms d’attributs de la v0.9.0 indiqués dans l’issue. Le travail est terminé lorsque les deux exemples importent les attributs depuis Mcp\Capability\Attribute\ afin de correspondre au SDK. Le class_alias suggéré est facultatif et nécessiterait une vérification distincte de la portée.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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.
- Langage dominant
- PHP
- Étoiles
- 1.7k
- Forks
- 206
- Merge moyen
- 1 j 17 h
- PR mergées (30 j)
- 102
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de modelcontextprotocol/php-sdk
-
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStanOuverteServer
Difficulté 1/5 Moins d'une heure Accessibilité débutants 78/100
modelcontextprotocol/php-sdk#468 · 3 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
enhancement P3
Difficulté 4/5 3-5 jours Accessibilité débutants 48/100
modelcontextprotocol/php-sdk#733 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
[Server] Handle notifications/cancelled on the handshake eraPeut-être pris @ump45nose l’a pris il y a 5 jours. Ouvertehelp wanted improves spec compliance Server
Difficulté 4/5 3-5 jours Accessibilité débutants 57/100
modelcontextprotocol/php-sdk#732 ·
Les mainteneurs répondent en général sous 1 jour
-
[Client][Server] Ship extension classes for the two authorization extensionsPeut-être pris @chr-hertel l’a pris il y a 6 jours. Ouverteauth Client Server
modelcontextprotocol/php-sdk#721 · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
-
[Client] Test cross-app access against a real identity providerPeut-être pris @chr-hertel l’a pris il y a 6 jours. Ouverteauth Client
modelcontextprotocol/php-sdk#720 · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de modelcontextprotocol/php-sdk
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
pluginsGLPI/carbon#396 ·
-
[BUG] Bundle products lose their price in RSS feeds: getPrices() was removedPeut-être pris @pcvelz l’a pris aujourd’hui. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 90/100
OpenMage/magento-lts#5869 ·
Les mainteneurs répondent en général sous 2 jours
-
Map Info Window ButtonsOuverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 90/100
OpenGIS/waymark-wp#82 ·
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
Les mainteneurs répondent en général sous 1 jour
-
claude
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
sprain/sprainocchio#39 ·
Les mainteneurs répondent en général sous 1 jour