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."];
+    }
+}

examples/explicit-registration/server.php

@@ -0,0 +1,47 @@
+#!/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\ExplicitRegistration\SimpleHandlers;
+use Mcp\Schema\ServerCapabilities;
+use Mcp\Server;
+
+logger()->info('Starting MCP Manual Registration Server...');
+
+$server = Server::builder()
+    ->setServerInfo('Explicit Registration Server', '1.0.0')
+    ->setLogger(logger())
+    ->setContainer(container())
+    ->addTool([SimpleHandlers::class, 'echoText'], 'echo_text')
+    ->addResource([SimpleHandlers::class, 'getAppVersion'], 'app://version', 'application_version', mimeType: 'text/plain')
+    ->addPrompt([SimpleHandlers::class, 'greetingPrompt'], 'personalized_greeting')
+    ->addResourceTemplate([SimpleHandlers::class, 'getItemDetails'], 'item://{itemId}/details', 'get_item_details', mimeType: 'application/json')
+    ->setCapabilities(new ServerCapabilities(
+        tools: true,
+        toolsListChanged: false,
+        resources: true,
+        resourcesSubscribe: false,
+        resourcesListChanged: false,
+        prompts: true,
+        promptsListChanged: false,
+        logging: false,
+        completions: false,
+    ))
+    ->build();
+
+$result = $server->run(transport());
+
+logger()->info('Server listener stopped gracefully.', ['result' => $result]);
+
+shutdown($result);