refactor: transport agnostic examples (#131)

examples/explicit-registration/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\ExplicitRegistration;
+
+use Psr\Log\LoggerInterface;
+
+final 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<string, string>[] 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<string, string> 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."];
+    }
+}