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

Adopt server examples

Browse source
This commit is contained in:
Christopher Hertel 2025-08-17 02:46:01 +02:00
commit 2ef051a355
No known key found for this signature in database
GPG key ID: 111F6BFF7B6B5AA3
6 changed files with 3639 additions and 756 deletions
Download patch file Download diff file Expand all files Collapse all files

19
src/Server/RequestHandler/CallToolHandler.php
View file

@ -11,13 +11,16 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Tool\ToolExecutorInterface;
use Mcp\Capability\Registry;
use Mcp\Exception\ExceptionInterface;
use Mcp\Schema\JsonRpc\Error;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\CallToolRequest;
use Mcp\Schema\Result\CallToolResult;
use Mcp\Server\MethodHandlerInterface;
use Psr\Log\LoggerInterface;
use Psr\Log\NullLogger;
/**
* @author Christopher Hertel <mail@christopher-hertel.de>
@ -26,7 +29,8 @@ use Mcp\Server\MethodHandlerInterface;
final class CallToolHandler implements MethodHandlerInterface
{
public function __construct(
private readonly ToolExecutorInterface $toolExecutor,
private readonly Registry $registry,
private readonly LoggerInterface $logger = new NullLogger(),
) {
}
@ -40,11 +44,16 @@ final class CallToolHandler implements MethodHandlerInterface
\assert($message instanceof CallToolRequest);
try {
$result = $this->toolExecutor->call($message);
} catch (ExceptionInterface) {
$content = $this->registry->handleCallTool($message->name, $message->arguments);
} catch (ExceptionInterface $exception) {
$this->logger->error(\sprintf('Error while executing tool "%s": "%s".', $message->name, $exception->getMessage()), [
'tool' => $message->name,
'arguments' => $message->arguments,
]);
return Error::forInternalError('Error while executing tool', $message->getId());
}
return new Response($message->getId(), $result);
return new Response($message->getId(), new CallToolResult($content));
}
}

9
src/Server/RequestHandler/GetPromptHandler.php
View file

@ -11,12 +11,13 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Prompt\PromptGetterInterface;
use Mcp\Capability\Registry;
use Mcp\Exception\ExceptionInterface;
use Mcp\Schema\JsonRpc\Error;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\GetPromptRequest;
use Mcp\Schema\Result\GetPromptResult;
use Mcp\Server\MethodHandlerInterface;
/**
@ -25,7 +26,7 @@ use Mcp\Server\MethodHandlerInterface;
final class GetPromptHandler implements MethodHandlerInterface
{
public function __construct(
private readonly PromptGetterInterface $getter,
private readonly Registry $registry,
) {
}
@ -39,11 +40,11 @@ final class GetPromptHandler implements MethodHandlerInterface
\assert($message instanceof GetPromptRequest);
try {
$result = $this->getter->get($message);
$messages = $this->registry->handleGetPrompt($message->name, $message->arguments);
} catch (ExceptionInterface) {
return Error::forInternalError('Error while handling prompt', $message->getId());
}
return new Response($message->getId(), $result);
return new Response($message->getId(), new GetPromptResult($messages));
}
}

20
src/Server/RequestHandler/ListPromptsHandler.php
View file

@ -11,11 +11,9 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Prompt\CollectionInterface;
use Mcp\Capability\Registry;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Prompt;
use Mcp\Schema\PromptArgument;
use Mcp\Schema\Request\ListPromptsRequest;
use Mcp\Schema\Result\ListPromptsResult;
use Mcp\Server\MethodHandlerInterface;
@ -26,7 +24,7 @@ use Mcp\Server\MethodHandlerInterface;
final class ListPromptsHandler implements MethodHandlerInterface
{
public function __construct(
private readonly CollectionInterface $collection,
private readonly Registry $registry,
private readonly int $pageSize = 20,
) {
}
@ -41,19 +39,7 @@ final class ListPromptsHandler implements MethodHandlerInterface
\assert($message instanceof ListPromptsRequest);
$cursor = null;
$prompts = [];
$metadataList = $this->collection->getMetadata($this->pageSize, $message->cursor);
foreach ($metadataList as $metadata) {
$cursor = $metadata->getName();
$prompts[] = new Prompt(
$metadata->getName(),
$metadata->getDescription(),
array_map(fn (array $data) => PromptArgument::fromArray($data), $metadata->getArguments()),
);
}
$prompts = $this->registry->getPrompts($this->pageSize, $message->cursor);
$nextCursor = (null !== $cursor && \count($prompts) === $this->pageSize) ? $cursor : null;
return new Response(

22
src/Server/RequestHandler/ListResourcesHandler.php
View file

@ -11,11 +11,10 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Resource\CollectionInterface;
use Mcp\Capability\Registry;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\ListResourcesRequest;
use Mcp\Schema\Resource;
use Mcp\Schema\Result\ListResourcesResult;
use Mcp\Server\MethodHandlerInterface;
@ -25,7 +24,7 @@ use Mcp\Server\MethodHandlerInterface;
final class ListResourcesHandler implements MethodHandlerInterface
{
public function __construct(
private readonly CollectionInterface $collection,
private readonly Registry $registry,
private readonly int $pageSize = 20,
) {
}
@ -40,22 +39,7 @@ final class ListResourcesHandler implements MethodHandlerInterface
\assert($message instanceof ListResourcesRequest);
$cursor = null;
$resources = [];
$metadataList = $this->collection->getMetadata($this->pageSize, $message->cursor);
foreach ($metadataList as $metadata) {
$cursor = $metadata->getUri();
$resources[] = new Resource(
$metadata->getUri(),
$metadata->getName(),
$metadata->getDescription(),
$metadata->getMimeType(),
null,
$metadata->getSize(),
);
}
$resources = $this->registry->getResources($this->pageSize, $message->cursor);
$nextCursor = (null !== $cursor && \count($resources) === $this->pageSize) ? $cursor : null;
return new Response(

24
src/Server/RequestHandler/ListToolsHandler.php
View file

@ -11,12 +11,11 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Tool\CollectionInterface;
use Mcp\Capability\Registry;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\ListToolsRequest;
use Mcp\Schema\Result\ListToolsResult;
use Mcp\Schema\Tool;
use Mcp\Server\MethodHandlerInterface;
/**
@ -26,7 +25,7 @@ use Mcp\Server\MethodHandlerInterface;
final class ListToolsHandler implements MethodHandlerInterface
{
public function __construct(
private readonly CollectionInterface $collection,
private readonly Registry $registry,
private readonly int $pageSize = 20,
) {
}
@ -41,24 +40,7 @@ final class ListToolsHandler implements MethodHandlerInterface
\assert($message instanceof ListToolsRequest);
$cursor = null;
$tools = [];
$metadataList = $this->collection->getMetadata($this->pageSize, $message->cursor);
foreach ($metadataList as $tool) {
$cursor = $tool->getName();
$inputSchema = $tool->getInputSchema();
$tools[] = new Tool(
$tool->getName(),
[] === $inputSchema ? [
'type' => 'object',
'$schema' => 'http://json-schema.org/draft-07/schema#',
] : $inputSchema,
$tool->getDescription(),
null,
);
}
$tools = $this->registry->getTools($this->pageSize, $message->cursor);
$nextCursor = (null !== $cursor && \count($tools) === $this->pageSize) ? $cursor : null;
return new Response(

9
src/Server/RequestHandler/ReadResourceHandler.php
View file

@ -11,13 +11,14 @@
namespace Mcp\Server\RequestHandler;
use Mcp\Capability\Resource\ResourceReaderInterface;
use Mcp\Capability\Registry;
use Mcp\Exception\ExceptionInterface;
use Mcp\Exception\ResourceNotFoundException;
use Mcp\Schema\JsonRpc\Error;
use Mcp\Schema\JsonRpc\HasMethodInterface;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\ReadResourceRequest;
use Mcp\Schema\Result\ReadResourceResult;
use Mcp\Server\MethodHandlerInterface;
/**
@ -26,7 +27,7 @@ use Mcp\Server\MethodHandlerInterface;
final class ReadResourceHandler implements MethodHandlerInterface
{
public function __construct(
private readonly ResourceReaderInterface $reader,
private readonly Registry $registry,
) {
}
@ -40,13 +41,13 @@ final class ReadResourceHandler implements MethodHandlerInterface
\assert($message instanceof ReadResourceRequest);
try {
$result = $this->reader->read($message);
$contents = $this->registry->handleReadResource($message->uri);
} catch (ResourceNotFoundException $e) {
return new Error($message->getId(), Error::RESOURCE_NOT_FOUND, $e->getMessage());
} catch (ExceptionInterface) {
return Error::forInternalError('Error while reading resource', $message->getId());
}
return new Response($message->getId(), $result);
return new Response($message->getId(), new ReadResourceResult($contents));
}
}