Adopt server examples

examples/03-manual-registration-stdio/SimpleHandlers.php

@@ -0,0 +1,81 @@
+<?php
+
+/*
+ * This file is part of the official PHP MCP SDK.
+ *
+ * A collaboration between Symfony and the PHP Foundation.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Mcp\Example\ManualStdioExample;
+
+use Psr\Log\LoggerInterface;
+
+class SimpleHandlers
+{
+    private string $appVersion = '1.0-manual';
+
+    public function __construct(
+        private readonly LoggerInterface $logger,
+    ) {
+        $this->logger->info('SimpleHandlers instantiated for manual registration example.');
+    }
+
+    /**
+     * A manually registered tool to echo input.
+     *
+     * @param string $text the text to echo
+     *
+     * @return string the echoed text
+     */
+    public function echoText(string $text): string
+    {
+        $this->logger->info("Manual tool 'echo_text' called.", ['text' => $text]);
+
+        return 'Echo: '.$text;
+    }
+
+    /**
+     * A manually registered resource providing app version.
+     *
+     * @return string the application version
+     */
+    public function getAppVersion(): string
+    {
+        $this->logger->info("Manual resource 'app://version' read.");
+
+        return $this->appVersion;
+    }
+
+    /**
+     * A manually registered prompt template.
+     *
+     * @param string $userName the name of the user
+     *
+     * @return array the prompt messages
+     */
+    public function greetingPrompt(string $userName): array
+    {
+        $this->logger->info("Manual prompt 'personalized_greeting' called.", ['userName' => $userName]);
+
+        return [
+            ['role' => 'user', 'content' => "Craft a personalized greeting for {$userName}."],
+        ];
+    }
+
+    /**
+     * A manually registered resource template.
+     *
+     * @param string $itemId the ID of the item
+     *
+     * @return array item details
+     */
+    public function getItemDetails(string $itemId): array
+    {
+        $this->logger->info("Manual template 'item://{itemId}' resolved.", ['itemId' => $itemId]);
+
+        return ['id' => $itemId, 'name' => "Item {$itemId}", 'description' => "Details for item {$itemId} from manual template."];
+    }
+}

examples/03-manual-registration-stdio/server.php

@@ -0,0 +1,33 @@
+#!/usr/bin/env php
+<?php
+
+/*
+ * This file is part of the official PHP MCP SDK.
+ *
+ * A collaboration between Symfony and the PHP Foundation.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+require_once dirname(__DIR__).'/bootstrap.php';
+chdir(__DIR__);
+
+use Mcp\Example\ManualStdioExample\SimpleHandlers;
+use Mcp\Server;
+use Mcp\Server\Transport\StdioTransport;
+
+logger()->info('Starting MCP Manual Registration (Stdio) Server...');
+
+Server::make()
+    ->withServerInfo('Manual Reg Server', '1.0.0')
+    ->withLogger(logger())
+    ->withContainer(container())
+    ->withTool([SimpleHandlers::class, 'echoText'], 'echo_text')
+    ->withResource([SimpleHandlers::class, 'getAppVersion'], 'app://version', 'application_version', mimeType: 'text/plain')
+    ->withPrompt([SimpleHandlers::class, 'greetingPrompt'], 'personalized_greeting')
+    ->withResourceTemplate([SimpleHandlers::class, 'getItemDetails'], 'item://{itemId}/details', 'get_item_details', mimeType: 'application/json')
+    ->build()
+    ->connect(new StdioTransport(logger: logger()));
+
+logger()->info('Server listener stopped gracefully.');