php-sdk/examples
Repository files (latest commit first)
Filename Latest commit message Latest commit date
xentixar 7d599f4f64
refactor: integrate cache parameter into setDiscovery() method (#80)
* refactor: integrate cache parameter into setDiscovery() method

- Add cache as 4th parameter to setDiscovery()
- Rename $cache to $discoveryCache for clarity
- Remove separate setCache() method
- Update example to use new API

* docs: update discovery caching documentation to use new API

- Update examples to use cache parameter in setDiscovery() method
- Remove references to separate setCache() method calls
2025-09-25 16:41:11 +02:00
..
01-discovery-stdio-calculator Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
02-discovery-http-userprofile Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
03-manual-registration-stdio Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
04-combined-registration-http Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
05-stdio-env-variables Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
06-custom-dependencies-stdio Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
07-complex-tool-schema-http Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
08-schema-showcase-streamable Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
09-cached-discovery-stdio refactor: integrate cache parameter into setDiscovery() method (#80) 2025-09-25 16:41:11 +02:00
bootstrap.php Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00
README.md Fix & clean up examples (#78) 2025-09-24 21:50:06 +02:00

MCP SDK Examples

This directory contains various examples of how to use the PHP MCP SDK.

You can run examples 01-08 with the dependencies already installed in the root directory of the SDK. For example 09, see the README in the examples/09-standalone-cli directory.

For running an example, you execute the server.php like this:

# For examples using STDIO transport
php examples/01-discovery-stdio-calculator/server.php

# For examples using Streamable HTTP transport
php -S localhost:8000 examples/02-discovery-http-userprofile/server.php

You will see debug outputs to help you understand what is happening.

Run with Inspector:

npx @modelcontextprotocol/inspector php examples/01-discovery-stdio-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:

npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/01-discovery-stdio-calculator/server.php