php-sdk/examples
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-10-07 23:32:51 +02:00
..
http-combined-registration Rename example folders (#87) 2025-10-04 19:45:40 +02:00
http-complex-tool-schema Rename example folders (#87) 2025-10-04 19:45:40 +02:00
http-discovery-userprofile feat: add completion/complete handler, centralize provider logic, and move completion capability (#97) 2025-10-07 10:34:50 +01:00
http-schema-showcase Rename example folders (#87) 2025-10-04 19:45:40 +02:00
stdio-cached-discovery Rename example folders (#87) 2025-10-04 19:45:40 +02:00
stdio-custom-dependencies Rename example folders (#87) 2025-10-04 19:45:40 +02:00
stdio-discovery-calculator Fix missing instructions from builder to handler (#90) 2025-10-07 23:32:51 +02:00
stdio-env-variables Rename example folders (#87) 2025-10-04 19:45:40 +02:00
stdio-explicit-registration Rename example folders (#87) 2025-10-04 19:45:40 +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