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

[Schema][Client][Server] Deprecate Roots, Sampling and Logging (SEP-2577) (#427)

Browse source 
* [Schema][Client][Server] Deprecate Roots, Sampling and Logging (SEP-2577)

* Emit runtime deprecation notices and document the migration (SEP-2596)
This commit is contained in:
Christopher Hertel 2026-08-18 01:23:32 +02:00 • committed by GitHub
commit 590afb575b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 120 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
src/Server/ClientGateway.php
View file

@ -99,9 +99,14 @@ class ClientGateway
/**
* Convenience method to send a logging notification to the client.
*
* @deprecated since protocol revision 2026-07-28 (SEP-2577), earliest removal 2027-07-28.
* Log to stderr (stdio) or use OpenTelemetry instead.
*/
public function log(LoggingLevel $level, mixed $data, ?string $logger = null): void
{
trigger_deprecation('mcp/sdk', '0.8', 'MCP logging is deprecated since protocol revision 2026-07-28 (SEP-2577); log to stderr or use OpenTelemetry instead.');
$this->notify(new LoggingMessageNotification($level, $data, $logger));
}
@ -135,9 +140,14 @@ class ClientGateway
* @return CreateSamplingMessageResult The sampling response
*
* @throws ClientException if the client request results in an error message
*
* @deprecated since protocol revision 2026-07-28 (SEP-2577), earliest removal 2027-07-28.
* Integrate with an LLM provider's API directly instead.
*/
public function sample(array|Content|string $message, int $maxTokens = 1000, int $timeout = 120, array $options = []): CreateSamplingMessageResult
{
trigger_deprecation('mcp/sdk', '0.8', 'MCP sampling is deprecated since protocol revision 2026-07-28 (SEP-2577); integrate with an LLM provider\'s API directly instead.');
$preferences = $options['preferences'] ?? null;
if (null !== $preferences && !$preferences instanceof ModelPreferences) {
throw new InvalidArgumentException('The "preferences" option must be an array or an instance of ModelPreferences.');
@ -227,9 +237,15 @@ class ClientGateway
* @return ListRootsResult The roots exposed by the client
*
* @throws ClientException if the client request results in an error message
*
* @deprecated since protocol revision 2026-07-28 (SEP-2577), earliest removal 2027-07-28.
* Pass directories or files through tool arguments, resource URIs or server
* configuration instead.
*/
public function listRoots(int $timeout = 120): ListRootsResult
{
trigger_deprecation('mcp/sdk', '0.8', 'MCP roots are deprecated since protocol revision 2026-07-28 (SEP-2577); pass directories through tool arguments or resource URIs instead.');
$request = new ListRootsRequest();
$response = $this->request($request, $timeout);