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

fix: use Docker PHP-FPM to support sampling in conformance tests (#219)

Browse source
This commit is contained in:
Kyrian Obikwelu 2026-01-02 15:59:56 +01:00 • committed by GitHub
commit 4c3e5e61c7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 144 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

130
examples/server/conformance/Elements.php
View file

@ -1,130 +0,0 @@
<?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\Example\Server\Conformance;
use Mcp\Schema\Content\Content;
use Mcp\Schema\Content\EmbeddedResource;
use Mcp\Schema\Content\ImageContent;
use Mcp\Schema\Content\PromptMessage;
use Mcp\Schema\Content\TextContent;
use Mcp\Schema\Content\TextResourceContents;
use Mcp\Schema\Enum\Role;
use Mcp\Server\Protocol;
use Mcp\Server\RequestContext;
final class Elements
{
// Sample base64 encoded 1x1 red PNG pixel for testing
public const TEST_IMAGE_BASE64 = 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8DwHwAFBQIAX8jx0gAAAABJRU5ErkJggg==';
// Sample base64 encoded minimal WAV file for testing
public const TEST_AUDIO_BASE64 = 'UklGRiYAAABXQVZFZm10IBAAAAABAAEAQB8AAAB9AAACABAAZGF0YQIAAAA=';
/**
* @return Content[]
*/
public function toolMultipleTypes(): array
{
return [
new TextContent('Multiple content types test:'),
new ImageContent(self::TEST_IMAGE_BASE64, 'image/png'),
EmbeddedResource::fromText(
'test://mixed-content-resource',
'{ "test" = "data", "value" = 123 }',
'application/json',
),
];
}
public function toolWithLogging(RequestContext $context): string
{
$logger = $context->getClientLogger();
$logger->info('Tool execution started');
$logger->info('Tool processing data');
$logger->info('Tool execution completed');
return 'Tool with logging executed successfully';
}
public function toolWithProgress(RequestContext $context): ?string
{
$client = $context->getClientGateway();
$client->progress(0, 100, 'Completed step 0 of 100');
$client->progress(50, 100, 'Completed step 0 of 100');
$client->progress(100, 100, 'Completed step 0 of 100');
$meta = $context->getSession()->get(Protocol::SESSION_ACTIVE_REQUEST_META, []);
return $meta['progressToken'] ?? null;
}
/**
* @param string $prompt The prompt to send to the LLM
*/
public function toolWithSampling(RequestContext $context, string $prompt): string
{
$result = $context->getClientGateway()->sample($prompt, 100);
return \sprintf('LLM response: %s', $result->content instanceof TextContent ? trim((string) $result->content->text) : '');
}
public function resourceTemplate(string $id): TextResourceContents
{
return new TextResourceContents(
uri: 'test://template/{id}/data',
mimeType: 'application/json',
text: json_encode([
'id' => $id,
'templateTest' => true,
'data' => \sprintf('Data for ID: %s', $id),
]),
);
}
/**
* @param string $arg1 First test argument
* @param string $arg2 Second test argument
*
* @return PromptMessage[]
*/
public function promptWithArguments(string $arg1, string $arg2): array
{
return [
new PromptMessage(Role::User, new TextContent(\sprintf('Prompt with arguments: arg1="%s", arg2="%s"', $arg1, $arg2))),
];
}
/**
* @param string $resourceUri URI of the resource to embed
*
* @return PromptMessage[]
*/
public function promptWithEmbeddedResource(string $resourceUri): array
{
return [
new PromptMessage(Role::User, EmbeddedResource::fromText($resourceUri, 'Embedded resource content for testing.')),
new PromptMessage(Role::User, new TextContent('Please process the embedded resource above.')),
];
}
/**
* @return PromptMessage[]
*/
public function promptWithImage(): array
{
return [
new PromptMessage(Role::User, new ImageContent(self::TEST_IMAGE_BASE64, 'image/png')),
new PromptMessage(Role::User, new TextContent('Please analyze the image above.')),
];
}
}

58
examples/server/conformance/server.php
View file

@ -1,58 +0,0 @@
<?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.
*/
require_once dirname(__DIR__).'/bootstrap.php';
chdir(__DIR__);
use Mcp\Example\Server\Conformance\Elements;
use Mcp\Schema\Content\AudioContent;
use Mcp\Schema\Content\EmbeddedResource;
use Mcp\Schema\Content\ImageContent;
use Mcp\Schema\Content\TextContent;
use Mcp\Schema\Result\CallToolResult;
use Mcp\Server;
use Mcp\Server\Session\FileSessionStore;
logger()->info('Starting MCP Custom Dependencies Server...');
$server = Server::builder()
->setServerInfo('mcp-conformance-test-server', '1.0.0')
->setSession(new FileSessionStore(__DIR__.'/sessions'))
->setLogger(logger())
// Tools
->addTool(fn () => 'This is a simple text response for testing.', 'test_simple_text', 'Tests simple text content response')
->addTool(fn () => new ImageContent(Elements::TEST_IMAGE_BASE64, 'image/png'), 'test_image_content', 'Tests image content response')
->addTool(fn () => new AudioContent(Elements::TEST_AUDIO_BASE64, 'audio/wav'), 'test_audio_content', 'Tests audio content response')
->addTool(fn () => EmbeddedResource::fromText('test://embedded-resource', 'This is an embedded resource content.'), 'test_embedded_resource', 'Tests embedded resource content response')
->addTool([Elements::class, 'toolMultipleTypes'], 'test_multiple_content_types', 'Tests response with multiple content types (text, image, resource)')
->addTool([Elements::class, 'toolWithLogging'], 'test_tool_with_logging', 'Tests tool that emits log messages during execution')
->addTool([Elements::class, 'toolWithProgress'], 'test_tool_with_progress', 'Tests tool that reports progress notifications')
->addTool(fn () => CallToolResult::error([new TextContent('This tool intentionally returns an error for testing')]), 'test_error_handling', 'Tests error response handling')
// TODO: Sampling gets stuck
// ->addTool([Elements::class, 'toolWithSampling'], 'test_sampling', 'Tests server-initiated sampling (LLM completion request)')
// Resources
->addResource(fn () => 'This is the content of the static text resource.', 'test://static-text', 'static-text', 'A static text resource for testing')
->addResource(fn () => fopen('data://image/png;base64,'.Elements::TEST_IMAGE_BASE64, 'r'), 'test://static-binary', 'static-binary', 'A static binary resource (image) for testing')
->addResourceTemplate([Elements::class, 'resourceTemplate'], 'test://template/{id}/data', 'template', 'A resource template with parameter substitution', 'application/json')
// TODO: Handler for resources/subscribe and resources/unsubscribe
->addResource(fn () => 'Watched resource content', 'test://watched-resource', 'watched-resource', 'A resource that auto-updates every 3 seconds')
// Prompts
->addPrompt(fn () => [['role' => 'user', 'content' => 'This is a simple prompt for testing.']], 'test_simple_prompt', 'A simple prompt without arguments')
->addPrompt([Elements::class, 'promptWithArguments'], 'test_prompt_with_arguments', 'A prompt with required arguments')
->addPrompt([Elements::class, 'promptWithEmbeddedResource'], 'test_prompt_with_embedded_resource', 'A prompt that includes an embedded resource')
->addPrompt([Elements::class, 'promptWithImage'], 'test_prompt_with_image', 'A prompt that includes image content')
->build();
$result = $server->run(transport());
logger()->info('Server listener stopped gracefully.', ['result' => $result]);
shutdown($result);