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

[Client] Feat: Implement MCP client component (#192)

Browse source 
* feat(client): add complete MCP client SDK with STDIO and HTTP transports

Add Client, Builder, ClientProtocol, ClientSession, and transport
implementations for communicating with MCP servers. Supports tools, resources, prompts, and real-time progress/logging notifications.

* refactor(examples): reorganize examples into server/ and client/ folders

* feat: add SamplingRequestHandler for handling server sampling requests

* feat: add setLoggingLevel method to control server logging verbosity

* refactor: make progress token dependent on request ID

* docs: Update server IP in usage instructions and add notes on sampling server requirements.

* feat: add complete() method for completion/complete requests

* refactor: properly parse and type initialize result

* refactor: standardize method names

* fix: revert changes to server related components

* fix: revert changes to server related components

* refactor: Restructure client transports and handlers into dedicated namespaces.

* fix: cs and php-stan errors fixes(partial)

* feat: Refactor request handlers to return `Response` or `Error` objects directly, adding a `SamplingException` and error logging for sampling requests.

* feat: Replace `ClientTransportInterface` with `TransportInterface` and move response result deserialization to client methods.

* refactor: remove redundant timeout check for intialize on transports

The processFiber that executes per tick while fiber is suspended already handles timeouts while waiting

* feat: broaden symfony/http-client dependency to support Symfony 5.4 to 8.0

* Update examples/client/README.md

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>

* Update examples/client/README.md

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>

* refactor: remove outgoing message queue from session and simplify transport send method to directly dispatch messages.

* refactor: Replace ClientSession with ClientState for clearer intent on runtime state management

* refactor: rename connectAndInitialize to connect for consistency

* chore: cs fix

* chore: use SamplingCallbackInterface instead of a closure for sampling request handler

---------

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>
This commit is contained in:
Kyrian Obikwelu 2026-03-10 17:22:40 +01:00 • committed by GitHub
commit 3ef864c444
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 2731 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

8
examples/server/README.md
View file

@ -8,10 +8,10 @@ The bootstrapping of the example will choose the used transport based on the SAP
For running an example, you execute the `server.php` like this:
```bash
# For using the STDIO transport:
php examples/discovery-calculator/server.php
php examples/server/discovery-calculator/server.php
# For using the Streamable HTTP transport:
php -S localhost:8000 examples/discovery-userprofile/server.php
php -S localhost:8000 examples/server/discovery-userprofile/server.php
```
You will see debug outputs to help you understand what is happening.
@ -19,7 +19,7 @@ You will see debug outputs to help you understand what is happening.
Run with Inspector:
```bash
npx @modelcontextprotocol/inspector php examples/discovery-calculator/server.php
npx @modelcontextprotocol/inspector php examples/server/discovery-calculator/server.php
```
## Debugging
@ -30,5 +30,5 @@ directory.
With the Inspector you can set the environment variables like this:
```bash
npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/discovery-calculator/server.php
npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/server/discovery-calculator/server.php
```

2
examples/server/bootstrap.php
View file

@ -55,7 +55,7 @@ function shutdown(ResponseInterface|int $result): never
function logger(): LoggerInterface
{
return new class extends AbstractLogger {
public function log($level, Stringable|string $message, array $context = []): void
public function log($level, string|Stringable $message, array $context = []): void
{
$debug = $_SERVER['DEBUG'] ?? false;

1
examples/server/client-communication/server.php
View file

@ -1,4 +1,3 @@
#!/usr/bin/env php
<?php
/*