3ef864c444* 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>
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# MCP SDK Examples
|
|
|
|
This directory contains various examples of how to use the PHP MCP SDK.
|
|
|
|
You can run the examples with the dependencies already installed in the root directory of the SDK.
|
|
The bootstrapping of the example will choose the used transport based on the SAPI you use.
|
|
|
|
For running an example, you execute the `server.php` like this:
|
|
```bash
|
|
# For using the STDIO transport:
|
|
php examples/server/discovery-calculator/server.php
|
|
|
|
# For using the Streamable HTTP transport:
|
|
php -S localhost:8000 examples/server/discovery-userprofile/server.php
|
|
```
|
|
|
|
You will see debug outputs to help you understand what is happening.
|
|
|
|
Run with Inspector:
|
|
|
|
```bash
|
|
npx @modelcontextprotocol/inspector php examples/server/discovery-calculator/server.php
|
|
```
|
|
|
|
## Debugging
|
|
|
|
You can enable debug output by setting the `DEBUG` environment variable to `1`, and additionally log to a file by
|
|
setting the `FILE_LOG` environment variable to `1` as well. A `dev.log` file gets written within the example's
|
|
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/server/discovery-calculator/server.php
|
|
```
|