Docs import a namespace that does not exist: Mcp\Server\Capability\Attribute\McpTool
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 1/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 85/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- php
- Área
- documentation
Línea de trabajo
Actualiza las importaciones en docs/get-started/first-server.md y README.md; empieza por comprobar los ejemplos existentes con los espacios de nombres de atributos de v0.9.0 indicados en el issue. La tarea estará completa cuando ambos ejemplos importen los atributos de Mcp\Capability\Attribute\ para que coincidan con el SDK. El class_alias sugerido es opcional y requeriría una revisión del alcance por separado.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- PHP
- Estrellas
- 1.7k
- Forks
- 206
- Merge medio
- 1 d 17 h
- PR fusionados (30 d)
- 102
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de modelcontextprotocol/php-sdk
-
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStanAbiertoServer
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
modelcontextprotocol/php-sdk#468 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
enhancement P3
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
modelcontextprotocol/php-sdk#733 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
[Server] Handle notifications/cancelled on the handshake eraPosiblemente ocupada @ump45nose la tomó hace 5 días. Abiertohelp wanted improves spec compliance Server
Dificultad 4/5 3-5 días Aptitud para principiantes 57/100
modelcontextprotocol/php-sdk#732 ·
Los mantenedores suelen responder en 1 día
-
[Client][Server] Ship extension classes for the two authorization extensionsPosiblemente ocupada @chr-hertel la tomó hace 6 días. Abiertoauth Client Server
modelcontextprotocol/php-sdk#721 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
[Client] Test cross-app access against a real identity providerPosiblemente ocupada @chr-hertel la tomó hace 6 días. Abiertoauth Client
modelcontextprotocol/php-sdk#720 · 1 asignado ·
Los mantenedores suelen responder en 1 día
Todos los issues de modelcontextprotocol/php-sdk
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
pluginsGLPI/carbon#396 ·
-
[BUG] Bundle products lose their price in RSS feeds: getPrices() was removedPosiblemente ocupada @pcvelz la tomó hoy. Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
OpenMage/magento-lts#5869 ·
Los mantenedores suelen responder en 2 días
-
Map Info Window ButtonsAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
OpenGIS/waymark-wp#82 ·
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día
-
claude
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
sprain/sprainocchio#39 ·
Los mantenedores suelen responder en 1 día