php-sdk/examples/server
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Tobias Nyholm ed205ef793
Use SchemaValidator to validate tool input (#203)
* Use SchemaValidator to validate tool input

* add test

* add changelog

* fix cs

* Improve error message

* fix tests

* fix tests

* fix baseline

* update snapshot files

* Remove BC compat while switching to v0.3.0

---------

Co-authored-by: Christopher Hertel <mail@christopher-hertel.de>
2026-01-11 21:46:53 +01:00
..
cached-discovery Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
client-communication Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
client-logging Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
combined-registration Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
complex-tool-schema Use SchemaValidator to validate tool input (#203) 2026-01-11 21:46:53 +01:00
custom-dependencies Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
custom-method-handlers Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
discovery-calculator Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
discovery-userprofile Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
env-variables feat: Add output schema support to MCP tools (#153) 2026-01-11 21:14:48 +01:00
explicit-registration Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
schema-showcase Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00
bootstrap.php Use the throwable object in $context['exception'] (#207) 2025-12-27 23:46:35 +01:00
README.md Move examples to server directory (#198) 2025-12-27 15:39:05 +01:00

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:

# For using the STDIO transport:
php examples/discovery-calculator/server.php

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

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

Run with Inspector:

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

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