68 lines
1.9 KiB
PHP
68 lines
1.9 KiB
PHP
<?php
|
|
|
|
/*
|
|
* 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\Tests\Unit\Capability\Discovery\Fixtures;
|
|
|
|
use Mcp\Capability\Attribute\McpTool;
|
|
use Mcp\Schema\ToolAnnotations;
|
|
use Mcp\Tests\Unit\Fixtures\Enum\BackedStringEnum;
|
|
|
|
class DiscoverableToolHandler
|
|
{
|
|
/**
|
|
* A basic discoverable tool.
|
|
*
|
|
* @param string $name the name to greet
|
|
*
|
|
* @return string the greeting
|
|
*/
|
|
#[McpTool(name: 'greet_user', description: 'Greets a user by name.')]
|
|
public function greet(string $name): string
|
|
{
|
|
return "Hello, {$name}!";
|
|
}
|
|
|
|
/**
|
|
* A tool with more complex parameters and inferred name/description.
|
|
*
|
|
* @param int $count the number of times to repeat
|
|
* @param bool $loudly Should it be loud?
|
|
* @param BackedStringEnum $mode the mode of operation
|
|
*
|
|
* @return array an array with results
|
|
*/
|
|
#[McpTool(annotations: new ToolAnnotations(readOnlyHint: true))]
|
|
public function repeatAction(int $count, bool $loudly = false, BackedStringEnum $mode = BackedStringEnum::OptionA): array
|
|
{
|
|
return ['count' => $count, 'loudly' => $loudly, 'mode' => $mode->value, 'message' => 'Action repeated.'];
|
|
}
|
|
|
|
// This method should NOT be discovered as a tool
|
|
public function internalHelperMethod(int $value): int
|
|
{
|
|
return $value * 2;
|
|
}
|
|
|
|
#[McpTool(name: 'private_tool_should_be_ignored')] // On private method
|
|
private function aPrivateTool(): void
|
|
{
|
|
}
|
|
|
|
#[McpTool(name: 'protected_tool_should_be_ignored')] // On protected method
|
|
protected function aProtectedTool(): void
|
|
{
|
|
}
|
|
|
|
#[McpTool(name: 'static_tool_should_be_ignored')] // On static method
|
|
public static function aStaticTool(): void
|
|
{
|
|
}
|
|
}
|