refactor: transport agnostic examples

Author: chr-hertel

examples/bootstrap.php

@@ -9,7 +9,13 @@
  * file that was distributed with this source code.
  */
 
+use Http\Discovery\Psr17Factory;
+use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;
 use Mcp\Capability\Registry\Container;
+use Mcp\Server\Transport\StdioTransport;
+use Mcp\Server\Transport\StreamableHttpTransport;
+use Mcp\Server\Transport\TransportInterface;
+use Psr\Http\Message\ResponseInterface;
 use Psr\Log\AbstractLogger;
 use Psr\Log\LoggerInterface;
 
@@ -21,6 +27,30 @@
     exit(1);
 });
 
+/**
+ * @return TransportInterface<int>|TransportInterface<ResponseInterface>
+ */
+function transport(): TransportInterface
+{
+    if ('cli' === \PHP_SAPI) {
+        return new StdioTransport();
+    }
+
+    return new StreamableHttpTransport(
+        (new Psr17Factory())->createServerRequestFromGlobals(),
+    );
+}
+
+function shutdown(ResponseInterface|int $result): never
+{
+    if ('cli' === \PHP_SAPI) {
+        exit($result);
+    }
+
+    (new SapiEmitter())->emit($result);
+    exit(0);
+}
+
 function logger(): LoggerInterface
 {
     return new class extends AbstractLogger {

examples/stdio-client-communication/server.php renamed to examples/client-communication/server.php

@@ -19,15 +19,12 @@
 use Mcp\Schema\ServerCapabilities;
 use Mcp\Server;
 use Mcp\Server\ClientGateway;
-use Mcp\Server\Transport\StdioTransport;
-
-$capabilities = new ServerCapabilities(logging: true, tools: true);
 
 $server = Server::builder()
-    ->setServerInfo('STDIO Client Communication Demo', '1.0.0')
+    ->setServerInfo('Client Communication Demo', '1.0.0')
     ->setLogger(logger())
     ->setContainer(container())
-    ->setCapabilities($capabilities)
+    ->setCapabilities(new ServerCapabilities(logging: true, tools: true))
     ->addTool(
         function (string $incidentTitle, ClientGateway $client): array {
             $client->log(LoggingLevel::Warning, sprintf('Incident triage started: %s', $incidentTitle));
@@ -108,8 +105,6 @@ function (string $dataset, ClientGateway $client): array {
     )
     ->build();
 
-$transport = new StdioTransport();
-
-$status = $server->run($transport);
+$result = $server->run(transport());
 
-exit($status);
+shutdown($result);

examples/http-client-communication/server.php

@@ -59,6 +59,6 @@ public static function provideMethods(): array
 
     protected function getServerScript(): string
     {
-        return \dirname(__DIR__, 3).'/examples/http-client-communication/server.php';
+        return \dirname(__DIR__, 3).'/examples/client-communication/server.php';
     }
 }