modelcontextprotocol/php-sdk
Watch
1
0
Fork
You've already forked php-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

[Server] Fix: standardize error handling across handlers with MCP specificatio… (#124)

Browse source 
* fix: standardize error handling across handlers with MCP specification compliance

* Update mcp-elements.md

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>

* docs: clarify error handling behavior for all element types

* docs: remove unnecessary whitespace in mcp-elements.md

* fix: simplify exception signatures to accept simple messages

* refactor: use specific exceptions in examples for better error handling

* feat: throw exceptions from reference provider instead of returning null

---------

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>
This commit is contained in:
Kyrian Obikwelu 2025-10-30 17:30:58 +01:00 • committed by GitHub
commit ca18caf29d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 278 additions and 185 deletions
Download patch file Download diff file Expand all files Collapse all files

11
examples/http-discovery-userprofile/McpElements.php
View file

@ -16,7 +16,8 @@ use Mcp\Capability\Attribute\McpPrompt;
use Mcp\Capability\Attribute\McpResource;
use Mcp\Capability\Attribute\McpResourceTemplate;
use Mcp\Capability\Attribute\McpTool;
use Mcp\Exception\InvalidArgumentException;
use Mcp\Exception\PromptGetException;
use Mcp\Exception\ResourceReadException;
use Psr\Log\LoggerInterface;
/**
@ -48,7 +49,7 @@ final class McpElements
*
* @return User user profile data
*
* @throws InvalidArgumentException if the user is not found
* @throws ResourceReadException if the user is not found
*/
#[McpResourceTemplate(
uriTemplate: 'user://{userId}/profile',
@ -62,7 +63,7 @@ final class McpElements
): array {
$this->logger->info('Reading resource: user profile', ['userId' => $userId]);
if (!isset($this->users[$userId])) {
throw new InvalidArgumentException("User profile not found for ID: {$userId}");
throw new ResourceReadException("User not found for ID: {$userId}");
}
return $this->users[$userId];
@ -130,7 +131,7 @@ final class McpElements
*
* @return array<string, string>[] prompt messages
*
* @throws InvalidArgumentException if user not found
* @throws PromptGetException if user not found
*/
#[McpPrompt(name: 'generate_bio_prompt')]
public function generateBio(
@ -140,7 +141,7 @@ final class McpElements
): array {
$this->logger->info('Executing prompt: generate_bio', ['userId' => $userId, 'tone' => $tone]);
if (!isset($this->users[$userId])) {
throw new InvalidArgumentException("User not found for bio prompt: {$userId}");
throw new PromptGetException("User not found for bio prompt: {$userId}");
}
$user = $this->users[$userId];