MCP Demo

Addressed comments

lint

Apply suggestion from @chr-hertel

Co-authored-by: Christopher Hertel <[email protected]>

revert .gitignore

Addressed comments

revert

README for testing

Update demo/README.md

Co-authored-by: Oskar Stark <[email protected]>

Update demo/README.md

Co-authored-by: Oskar Stark <[email protected]>

Update demo/README.md

Co-authored-by: Christopher Hertel <[email protected]>

Author: tom-hart-sky-uk

demo/README.md

@@ -90,3 +90,32 @@ docker compose exec app bin/console app:blog:query
 * The UI is coupled to a [Twig LiveComponent](https://symfony.com/bundles/ux-live-component/current/index.html), that integrates different `Chat` implementations on top of the user's session.
 * You can reset the chat context by hitting the `Reset` button in the top right corner.
 * You find three different usage scenarios in the upper navbar.
+
+### MCP
+
+Demo MCP server added with a `current-time` tool to return the current time, with an optional format string.
+
+To add the server, add the following configuration to your MCP Client's settings, e.g. your IDE:
+```json
+{
+    "servers": {
+        "symfony": {
+            "command": "php",
+            "args": [
+                "/your/full/path/to/bin/console",
+                "mcp:server"
+            ]
+        }
+    }
+}
+```
+
+#### Testing the MCP Server
+
+You can test the MCP server by running the following command to start the MCP client:
+
+```shell
+php bin/console mcp:server
+```
+
+Then, paste `{"method":"tools/list","jsonrpc":"2.0","id":1}` to list the tools available on the MCP server.

demo/composer.json

@@ -25,6 +25,7 @@
         "symfony/flex": "^2.5",
         "symfony/framework-bundle": "7.3.*",
         "symfony/http-client": "7.3.*",
+        "symfony/mcp-bundle": "@dev",
         "symfony/monolog-bundle": "^3.10",
         "symfony/runtime": "7.3.*",
         "symfony/twig-bundle": "7.3.*",

demo/composer.lock

@@ -23,4 +23,5 @@
     Symfony\UX\Icons\UXIconsBundle::class => ['all' => true],
     Symfony\UX\Typed\TypedBundle::class => ['all' => true],
     Symfony\AI\AIBundle\AIBundle::class => ['all' => true],
+    Symfony\AI\McpBundle\McpBundle::class => ['all' => true],
 ];

demo/config/bundles.php

@@ -0,0 +1,5 @@
+mcp:
+    app: demo-app
+    version: 0.0.1
+    client_transports:
+        stdio: true

demo/config/packages/mcp.yaml

@@ -18,3 +18,11 @@ services:
             - '../src/DependencyInjection/'
             - '../src/Entity/'
             - '../src/Kernel.php'
+
+    Symfony\AI\McpSdk\Capability\Tool\ToolExecutorInterface:
+        class: Symfony\AI\McpSdk\Capability\ToolChain
+        arguments:
+            - ['@App\MCP\Tools\CurrentTimeTool']
+
+    Symfony\AI\McpSdk\Capability\Tool\CollectionInterface:
+        alias: Symfony\AI\McpSdk\Capability\Tool\ToolExecutorInterface

demo/config/services.yaml

@@ -0,0 +1,57 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\MCP\Tools;
+
+use Symfony\AI\McpSdk\Capability\Tool\MetadataInterface;
+use Symfony\AI\McpSdk\Capability\Tool\ToolCall;
+use Symfony\AI\McpSdk\Capability\Tool\ToolCallResult;
+use Symfony\AI\McpSdk\Capability\Tool\ToolExecutorInterface;
+
+/**
+ * @author Tom Hart <[email protected]>
+ */
+class CurrentTimeTool implements MetadataInterface, ToolExecutorInterface
+{
+    public function call(ToolCall $input): ToolCallResult
+    {
+        $format = $input->arguments['format'] ?? 'Y-m-d H:i:s';
+
+        return new ToolCallResult(
+            (new \DateTime('now', new \DateTimeZone('UTC')))->format($format)
+        );
+    }
+
+    public function getName(): string
+    {
+        return 'current-time';
+    }
+
+    public function getDescription(): string
+    {
+        return 'Returns the current time in UTC';
+    }
+
+    public function getInputSchema(): array
+    {
+        return [
+            'type' => 'object',
+            'properties' => [
+                'format' => [
+                    'type' => 'string',
+                    'description' => 'The format of the time, e.g. "Y-m-d H:i:s"',
+                    'default' => 'Y-m-d H:i:s',
+                ],
+            ],
+            'required' => ['format'],
+        ];
+    }
+}

demo/src/MCP/Tools/CurrentTimeTool.php

@@ -134,6 +134,9 @@
             "src/Kernel.php"
         ]
     },
+    "symfony/mcp-bundle": {
+        "version": "dev-main"
+    },
     "symfony/monolog-bundle": {
         "version": "3.10",
         "recipe": {