ca18caf29d* 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>
54 lines
1.2 KiB
PHP
54 lines
1.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/*
|
|
* This file is part of the official PHP MCP SDK.
|
|
*
|
|
* A collaboration between Symfony and the PHP Foundation.
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Mcp\Example\StdioCachedDiscovery;
|
|
|
|
use Mcp\Capability\Attribute\McpTool;
|
|
use Mcp\Exception\ToolCallException;
|
|
|
|
/**
|
|
* Example MCP elements for demonstrating cached discovery.
|
|
*
|
|
* This class contains simple calculator tools that will be discovered
|
|
* and cached for improved performance on subsequent server starts.
|
|
*/
|
|
class CachedCalculatorElements
|
|
{
|
|
#[McpTool(name: 'add_numbers')]
|
|
public function add(int $a, int $b): int
|
|
{
|
|
return $a + $b;
|
|
}
|
|
|
|
#[McpTool(name: 'multiply_numbers')]
|
|
public function multiply(int $a, int $b): int
|
|
{
|
|
return $a * $b;
|
|
}
|
|
|
|
#[McpTool(name: 'divide_numbers')]
|
|
public function divide(int $a, int $b): float
|
|
{
|
|
if (0 === $b) {
|
|
throw new ToolCallException('Division by zero is not allowed');
|
|
}
|
|
|
|
return $a / $b;
|
|
}
|
|
|
|
#[McpTool(name: 'power')]
|
|
public function power(int $base, int $exponent): int
|
|
{
|
|
return (int) $base ** $exponent;
|
|
}
|
|
}
|