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

[Server][Client] Bridge W3C trace context between HTTP headers and _meta (SEP-414) (#473)

Browse source 
RequestMeta::parseTraceContext() now falls back to the native traceparent/
tracestate/baggage HTTP headers when _meta carries none, and HeaderFactory
mirrors an application-set _meta trace context onto those same headers on
outbound requests. _meta wins when both are present.
This commit is contained in:
Christopher Hertel 2026-08-24 01:26:22 +02:00 • committed by GitHub
commit d59950f1ac
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 134 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

47
tests/Unit/Server/Stateless/StatelessProtocolTest.php
View file

@ -643,6 +643,53 @@ class StatelessProtocolTest extends TestCase
);
}
#[TestDox('a native traceparent/tracestate header reaches the handler when `_meta` carries none')]
public function testHttpTraceHeadersReachTheHandler(): void
{
$answer = self::call(
self::protocol(),
'tools/call',
['name' => 'probe_trace', 'arguments' => []],
[
'Mcp-Name' => 'probe_trace',
'traceparent' => '00-0af7651916cd43dd8448eb211c80319c-00f067aa0ba902b7-01',
'tracestate' => 'acme=1',
],
);
$this->assertSame(
'traceparent=00-0af7651916cd43dd8448eb211c80319c-00f067aa0ba902b7-01;tracestate=acme=1',
$answer['body']['result']['content'][0]['text'],
);
}
#[TestDox('`_meta` trace context wins over a conflicting native header')]
public function testMetaTraceContextWinsOverHeader(): void
{
$answer = self::call(
self::protocol(),
'tools/call',
[
'name' => 'probe_trace',
'arguments' => [],
'_meta' => [
RequestMeta::PROTOCOL_VERSION => ProtocolVersion::V2026_07_28->value,
RequestMeta::CLIENT_CAPABILITIES => new \stdClass(),
'traceparent' => '00-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbbbbbbbbbb-01',
],
],
[
'Mcp-Name' => 'probe_trace',
'traceparent' => '00-0af7651916cd43dd8448eb211c80319c-00f067aa0ba902b7-01',
],
);
$this->assertSame(
'traceparent=00-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbbbbbbbbbb-01',
$answer['body']['result']['content'][0]['text'],
);
}
#[TestDox('notifications caused by a traced request carry its trace context')]
public function testNotificationsCarryTheTraceContext(): void
{