rebase after example renaming

Author: chr-hertel

docs/examples.md

@@ -32,13 +32,13 @@ STDIO examples use standard input/output for communication:
 
 ```bash
 # Interactive testing with MCP Inspector
-npx @modelcontextprotocol/inspector php examples/01-discovery-stdio-calculator/server.php
+npx @modelcontextprotocol/inspector php examples/stdio-discovery-calculator/server.php
 
 # Run with debugging enabled
-npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/01-discovery-stdio-calculator/server.php
+npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/stdio-discovery-calculator/server.php
 
 # Or configure the script path in your MCP client
-# Path: php examples/01-discovery-stdio-calculator/server.php
+# Path: php examples/stdio-discovery-calculator/server.php
 ```
 
 ### HTTP Examples
@@ -47,7 +47,7 @@ HTTP examples run as web servers:
 
 ```bash
 # Start the server
-php -S localhost:8000 examples/02-discovery-http-userprofile/server.php
+php -S localhost:8000 examples/http-discovery-userprofile/server.php
 
 # Test with MCP Inspector
 npx @modelcontextprotocol/inspector http://localhost:8000
@@ -61,9 +61,9 @@ curl -X POST http://localhost:8000 \
 
 ## STDIO Examples
 
-### 01. Discovery STDIO Calculator
+### Discovery Calculator
 
-**File**: `examples/01-discovery-stdio-calculator/`
+**File**: `examples/stdio-discovery-calculator/`
 
 **What it demonstrates:**
 - Attribute-based discovery using `#[McpTool]` and `#[McpResource]`
@@ -87,14 +87,14 @@ public function getConfiguration(): array
 **Usage:**
 ```bash
 # Interactive testing
-npx @modelcontextprotocol/inspector php examples/01-discovery-stdio-calculator/server.php
+npx @modelcontextprotocol/inspector php examples/stdio-discovery-calculator/server.php
 
-# Or configure in MCP client: php examples/01-discovery-stdio-calculator/server.php
+# Or configure in MCP client: php examples/stdio-discovery-calculator/server.php
 ```
 
-### 03. Manual Registration STDIO
+### Explicit Registration
 
-**File**: `examples/03-manual-registration-stdio/`
+**File**: `examples/stdio-explicit-registration/`
 
 **What it demonstrates:**
 - Manual registration of tools, resources, and prompts
@@ -109,9 +109,9 @@ $server = Server::builder()
     ->addPrompt([SimpleHandlers::class, 'greetingPrompt'], 'personalized_greeting')
 ```
 
-### 05. STDIO Environment Variables
+### Environment Variables
 
-**File**: `examples/05-stdio-env-variables/`
+**File**: `examples/stdio-env-variables/`
 
 **What it demonstrates:**
 - Environment variable integration
@@ -123,9 +123,9 @@ $server = Server::builder()
 - Conditional behavior based on environment
 - Environment validation and defaults
 
-### 06. Custom Dependencies STDIO
+### Custom Dependencies
 
-**File**: `examples/06-custom-dependencies-stdio/`
+**File**: `examples/stdio-custom-dependencies/`
 
 **What it demonstrates:**
 - Dependency injection with PSR-11 containers
@@ -143,9 +143,9 @@ $server = Server::builder()
     ->setDiscovery(__DIR__, ['.'])
 ```
 
-### 09. Cached Discovery STDIO
+### Cached Discovery
 
-**File**: `examples/09-cached-discovery-stdio/`
+**File**: `examples/stdio-cached-discovery/`
 
 **What it demonstrates:**
 - Discovery caching for improved performance
@@ -165,9 +165,9 @@ $server = Server::builder()
 
 ## HTTP Examples
 
-### 02. Discovery HTTP User Profile
+### Discovery User Profile
 
-**File**: `examples/02-discovery-http-userprofile/`
+**File**: `examples/http-discovery-userprofile/`
 
 **What it demonstrates:**
 - HTTP transport with StreamableHttpTransport
@@ -195,17 +195,17 @@ public function generateBio(string $userId, string $tone = 'professional'): arra
 **Usage:**
 ```bash
 # Start the HTTP server
-php -S localhost:8000 examples/02-discovery-http-userprofile/server.php
+php -S localhost:8000 examples/http-discovery-userprofile/server.php
 
 # Test with MCP Inspector
 npx @modelcontextprotocol/inspector http://localhost:8000
 
 # Or configure in MCP client: http://localhost:8000
 ```
 
-### 04. Combined Registration HTTP
+### Combined Registration
 
-**File**: `examples/04-combined-registration-http/`
+**File**: `examples/http-combined-registration/`
 
 **What it demonstrates:**
 - Mixing attribute discovery with manual registration
@@ -220,9 +220,9 @@ $server = Server::builder()
     ->addResource([ManualHandlers::class, 'getPriorityConfig'], 'config://priority')
 ```
 
-### 07. Complex Tool Schema HTTP
+### Complex Tool Schema
 
-**File**: `examples/07-complex-tool-schema-http/`
+**File**: `examples/http-complex-tool-schema/`
 
 **What it demonstrates:**
 - Advanced JSON schema definitions
@@ -243,9 +243,9 @@ $server = Server::builder()
 public function scheduleEvent(array $eventData): array
 ```
 
-### 08. Schema Showcase Streamable
+### Schema Showcase
 
-**File**: `examples/08-schema-showcase-streamable/`
+**File**: `examples/http-schema-showcase/`
 
 **What it demonstrates:**
 - Comprehensive JSON schema features

docs/transports.md

@@ -342,21 +342,9 @@ npx @modelcontextprotocol/inspector http://localhost:8000
 
 ## Choosing a Transport
 
-### Use STDIO When:
+The choice between STDIO and HTTP transport depends on the client you want to integrate with.
+If you are integrating with a client that is running **locally** (like Claude Desktop), use STDIO.
+If you are building a server in a distributed environment and need to integrate with a **remote** client, use Streamable HTTP.
 
-- Building command-line tools
-- Integrating with MCP clients (Claude Desktop, etc.)
-- Simple request/response patterns
-- Process-based isolation is desired
-- Single session per process
-
-### Use HTTP When:
-
-- Building web services
-- Need browser compatibility
-- Integration with web frameworks
-- Multiple concurrent sessions
-- Web-based MCP clients
-- RESTful API patterns
-
-The key difference is that STDIO is process-based (one session per process) while HTTP is request-based (multiple sessions via headers).
+One additiona difference to consider is that STDIO is process-based (one session per process) while HTTP is
+request-based (multiple sessions via headers).

examples/README.md

@@ -2,24 +2,23 @@
 
 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.
+You can run the examples with the dependencies already installed in the root directory of the SDK.
 
 For running an example, you execute the `server.php` like this:
 ```bash
 # For examples using STDIO transport
-php examples/01-discovery-stdio-calculator/server.php
+php examples/stdio-discovery-calculator/server.php
 
 # For examples using Streamable HTTP transport
-php -S localhost:8000 examples/02-discovery-http-userprofile/server.php
+php -S localhost:8000 examples/http-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/01-discovery-stdio-calculator/server.php
+npx @modelcontextprotocol/inspector php examples/stdio-discovery-calculator/server.php
 ```
 
 ## Debugging
@@ -30,5 +29,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/01-discovery-stdio-calculator/server.php
+npx @modelcontextprotocol/inspector -e DEBUG=1 -e FILE_LOG=1 php examples/stdio-discovery-calculator/server.php
 ```