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

[Client] Speak the 2026-07-28 lifecycle (#456)

Browse source 
* [Client] Speak the 2026-07-28 lifecycle

On that revision the client opens with server/discover instead of
initialize, stamps each request's _meta with the protocol version, its own
capabilities and client info, and sends the standard Mcp-Method / Mcp-Name /
Mcp-Param-* headers an intermediary routes on. ToolCatalog is what knows,
from the tool list, which arguments a call has to mirror.

An input_required result is answered rather than surfaced: InputRequestResolver
asks the host's elicitation, sampling and roots handlers and retries the same
request carrying inputResponses and the requestState the server sent.

McpHeader holds the header names and the =?base64?…?= sentinel, so the two
sides no longer keep their own copies of the same rules.

* Fix CI baseline drift and address Copilot review findings

Drop stale expected-failure entries the new client fixture now passes.

Copilot review: fix McpHeader round-trip for a wrapper-shaped literal,
encode empty/numeric-keyed inputResponses as a JSON object, stop the
incident example repeating side effects on MRTR retry, and reset
ToolCatalog on reconnect instead of carrying the previous server's
verdicts.

* Skip DualEraExampleTestCase on PHP 8.1

PHP_CLI_SERVER_WORKERS does not reliably fork multiple php -S
workers there (php/php-src#9400), reproducing the single-worker
deadlock the extra workers exist to avoid.
This commit is contained in:
Christopher Hertel 2026-08-19 02:41:02 +02:00 • committed by GitHub
commit 8c06dcecc6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 2443 additions and 248 deletions
Download patch file Download diff file Expand all files Collapse all files

133
tests/Conformance/client.php
View file

@ -16,6 +16,7 @@ use Mcp\Client\Handler\Request\RequestHandlerInterface;
use Mcp\Client\Transport\HttpTransport;
use Mcp\Schema\ClientCapabilities;
use Mcp\Schema\Enum\ElicitAction;
use Mcp\Schema\Enum\ProtocolVersion;
use Mcp\Schema\JsonRpc\Request;
use Mcp\Schema\JsonRpc\Response;
use Mcp\Schema\Request\ElicitRequest;
@ -30,35 +31,53 @@ if (!$url || !$scenario) {
exit(1);
}
// The runner names the revision it is testing; without honouring it the client
// would open every scenario with `initialize` and never reach the modern wire.
$version = ProtocolVersion::tryFrom(getenv('MCP_CONFORMANCE_PROTOCOL_VERSION') ?: '')
?? ProtocolVersion::V2025_11_25;
// Scenario-specific data (tool arguments, credentials) the runner passes in.
$context = json_decode(getenv('MCP_CONFORMANCE_CONTEXT') ?: '[]', true);
$context = is_array($context) ? $context : [];
@mkdir(__DIR__.'/logs', 0777, true);
$logger = new FileLogger(__DIR__.'/logs/client-conformance.log', true);
$logger->info(sprintf('Starting client conformance test: scenario=%s, url=%s', $scenario, $url));
$logger->info(sprintf('Starting client conformance test: scenario=%s, url=%s, version=%s', $scenario, $url, $version->value));
$builder = Client::builder()
->setClientInfo('mcp-conformance-test-client', '1.0.0')
->setProtocolVersion($version)
->setInitTimeout(30)
->setRequestTimeout(60)
->setLogger($logger);
if ('elicitation-sep1034-client-defaults' === $scenario) {
/**
* Accepts every elicitation with an empty payload.
*
* Enough for the scenarios here, which check that the client asked and echoed
* correctly rather than what a user would have typed.
*/
$acceptElicitation = new class($logger) implements RequestHandlerInterface {
public function __construct(private readonly Psr\Log\LoggerInterface $logger)
{
}
public function supports(Request $request): bool
{
return $request instanceof ElicitRequest;
}
public function handle(Request $request): Response
{
$this->logger->info('Received elicitation request, accepting with empty content');
return new Response($request->getId(), new ElicitResult(ElicitAction::Accept, []));
}
};
if (in_array($scenario, ['elicitation-sep1034-client-defaults', 'sep-2322-client-request-state'], true)) {
$builder->setCapabilities(new ClientCapabilities(elicitation: true));
$builder->addRequestHandler(new class($logger) implements RequestHandlerInterface {
public function __construct(private readonly Psr\Log\LoggerInterface $logger)
{
}
public function supports(Request $request): bool
{
return $request instanceof ElicitRequest;
}
public function handle(Request $request): Response
{
$this->logger->info('Received elicitation request, accepting with empty content');
return new Response($request->getId(), new ElicitResult(ElicitAction::Accept, []));
}
});
$builder->addRequestHandler($acceptElicitation);
}
$client = $builder->build();
@ -76,9 +95,11 @@ try {
break;
case 'tools_call':
$toolName = $toolsResult->tools[0]->name ?? 'test-tool';
$client->callTool($toolName, []);
$logger->info(sprintf('Called tool: %s', $toolName));
// The scenario asserts both arguments arrive as numbers, so the
// call has to be made by name with real values rather than
// whatever tool happens to be listed first.
$client->callTool('add_numbers', ['a' => 2, 'b' => 3]);
$logger->info('Called tool: add_numbers');
break;
case 'elicitation-sep1034-client-defaults':
@ -87,6 +108,74 @@ try {
$logger->info(sprintf('Called tool: %s', $toolName));
break;
case 'json-schema-2020-12-preservation':
// Round-trips the focal tool's inputSchema back through the echo
// tool so the harness can diff what survived the client's parsing
// (SEP-1613 keywords, plus the SEP-2106 vocabulary).
$focal = null;
foreach ($toolsResult->tools as $tool) {
if ('json_schema_2020_12_tool' === $tool->name) {
$focal = $tool;
break;
}
}
if (null === $focal) {
throw new RuntimeException('Mock server did not advertise json_schema_2020_12_tool.');
}
$client->callTool('json_schema_echo', ['schema' => $focal->inputSchema]);
$logger->info('Echoed the observed inputSchema back via json_schema_echo');
break;
case 'http-standard-headers':
// Exercises every method that carries an Mcp-Method or Mcp-Name
// header, including the ones whose subject needs Base64 wrapping.
foreach ($toolsResult->tools as $tool) {
$client->callTool($tool->name, []);
}
$resources = $client->listResources();
foreach ($resources->resources as $resource) {
$client->readResource($resource->uri);
}
$prompts = $client->listPrompts();
foreach ($prompts->prompts as $prompt) {
$client->getPrompt($prompt->name, []);
}
$logger->info('Exercised every header-carrying method');
break;
case 'http-custom-headers':
// The runner supplies the exact argument values, each chosen to hit
// a different corner of the encoding rules.
foreach ($context['toolCalls'] ?? [] as $call) {
$client->callTool($call['name'], $call['arguments'] ?? []);
$logger->info(sprintf('Called tool: %s', $call['name']));
}
break;
case 'http-invalid-tool-headers':
// Only the tools that survived the listing are callable; calling
// any of the malformed ones is the failure this scenario looks for.
foreach ($toolsResult->tools as $tool) {
$client->callTool($tool->name, ['region' => 'us-west1']);
$logger->info(sprintf('Called tool: %s', $tool->name));
}
break;
case 'sep-2322-client-request-state':
// Each tool drives one rule: echo the state back, omit it when none
// was sent, keep an unrelated call clean, and treat a result with
// no resultType as complete.
foreach (['test_mrtr_echo_state', 'test_mrtr_unrelated', 'test_mrtr_no_state', 'test_mrtr_no_result_type'] as $tool) {
$client->callTool($tool, []);
$logger->info(sprintf('Called tool: %s', $tool));
}
break;
default:
$logger->warning(sprintf('Unknown scenario: %s', $scenario));
break;