feature #637 [MCP Bundle] Migrate from symfony/mcp-sdk to official mcp/sdk (camilleislasse)

This PR was merged into the main branch.

Discussion
----------

  [MCP Bundle] Migrate from `symfony/mcp-sdk` to official `mcp/sdk`

  | Q             | A
  | ------------- | ---
  | Bug fix?      | no
  | New feature?  | yes
  | Docs?         | yes
  | Issues        | Fix #526
  | License       | MIT

  ## Summary

  This PR migrates the MCP Bundle from the internal `symfony/mcp-sdk` to the official `mcp/sdk` package and completely removes the internal MCP SDK component.

  ## Changes

  ### Remove Internal MCP SDK
  - **Deleted entire `src/mcp-sdk/` directory**
  - **Removed dependency** from `symfony/mcp-sdk` to `mcp/sdk`
  - **Updated all references** in documentation and configuration files

  ### MCP Bundle Migration
  - **Dependency change**: `symfony/mcp-sdk` → `mcp/sdk` in composer.json
  - **Server creation**: Refactored to use `Server::make()` builder pattern
  - **Service configuration**: Simplified using official SDK patterns

  ### New MCP Capabilities Support
  - **Attribute-based discovery**: Added support for `#[McpTool]`, `#[McpPrompt]`, `#[McpResource]`, `#[McpResourceTemplate]`
  - **Compiler passes**: Created `McpToolPass`, `McpPromptPass`, `McpResourcePass`, `McpResourceTemplatePass`
  - **Autoconfiguration**: Automatic service tagging and registration

  ### Bundle Enhancements
  - **EventDispatcher integration**: Added Symfony EventDispatcher for MCP SDK events
  - **Dedicated logger**: Added `monolog.logger.mcp` service
  - **Configuration options**: Added `pagination_limit` and `instructions` parameters
  - **Route loading**: Fixed RouteLoader registration for SSE transport

  ### Demo Application Updates
  - **Added new MCP examples**:
    - `CurrentTimePrompt.php` - Prompt capability
    - `CurrentTimeResource.php` - Resource capability
    - `CurrentTimeResourceTemplate.php` - Resource template capability
  - **Updated tool implementation**: Migrated `CurrentTimeTool.php` from interface to attribute
  - **Enhanced configuration**: Added pagination_limit, instructions

  ### Documentation
  - **rewrite** of `doc/index.rst` with examples for all capability types
  - **Event system documentation** with listener examples
  - **Logging configuration** guide
  - **Updated README and CHANGELOG** to reflect official SDK usage

  ### Testing
  - **Added tests** for all compiler passes
  - **Updated bundle tests** for new configuration options
  - **Added EventDispatcher test coverage**

  ## Breaking Changes

  - **Tool definition**: Use `#[McpTool]` attribute instead of implementing interfaces
  - **Dependency**: Replace `symfony/mcp-sdk` with `mcp/sdk` in composer.json

  ## Code Examples

  **Before (interface-based):**
  ```php
  class Tool implements MetadataInterface, ToolExecutorInterface {
      public function call(ToolCall $request): ToolCallResult {
          return new ToolCallResult($result);
      }
      public function getName(): string { return 'tool-name'; }
  }

  After (attribute-based):
  class Tool {
      #[McpTool(name: 'tool-name')]
      public function execute(string $param): string {
          return $result;
      }
  }

  New capabilities:
  #[McpPrompt(name: 'analysis')]
  public function getPrompt(): array { ... }

  #[McpResource(uri: 'data://current', name: 'current-data')]
  public function getResource(): array { ... }

  #[McpResourceTemplate(uriTemplate: 'data://{id}', name: 'data-by-id')]
  public function getTemplate(string $id): array { ... }

Commits
-------

1382d4c Migrate MCP Bundle from symfony/mcp-sdk to official mcp/sdk

Author: chr-hertel

.phpstan/ForbidNativeExceptionRule.php

@@ -51,7 +51,6 @@ final class ForbidNativeExceptionRule implements Rule
         'Symfony\\AI\\Agent' => 'Symfony\\AI\\Agent\\Exception\\',
         'Symfony\\AI\\Platform' => 'Symfony\\AI\\Platform\\Exception\\',
         'Symfony\\AI\\Store' => 'Symfony\\AI\\Store\\Exception\\',
-        'Symfony\\AI\\McpSdk' => 'Symfony\\AI\\McpSdk\\Exception\\',
         'Symfony\\AI\\AiBundle' => 'Symfony\\AI\\AiBundle\\Exception\\',
         'Symfony\\AI\\McpBundle' => 'Symfony\\AI\\McpBundle\\Exception\\',
     ];

AGENTS.md

@@ -12,11 +12,10 @@ Symfony AI monorepo with independent packages for AI integration in PHP applicat
 - **Platform** (`src/platform/`): Unified AI platform interface (OpenAI, Anthropic, Azure, Gemini, VertexAI)
 - **Agent** (`src/agent/`): AI agent framework for user interaction and task execution
 - **Store** (`src/store/`): Data storage abstraction with vector database support
-- **MCP SDK** (`src/mcp-sdk/`): Model Context Protocol SDK for agent-tool communication
 
 ### Integration Bundles
 - **AI Bundle** (`src/ai-bundle/`): Symfony integration for Platform, Store, and Agent
-- **MCP Bundle** (`src/mcp-bundle/`): Symfony integration for MCP SDK
+- **MCP Bundle** (`src/mcp-bundle/`): Symfony integration for official MCP SDK
 
 ### Supporting Directories
 - **Examples** (`examples/`): Standalone usage examples

CLAUDE.md

@@ -12,11 +12,10 @@ This is the Symfony AI monorepo containing multiple components and bundles that
 - **Platform** (`src/platform/`): Unified interface to AI platforms (OpenAI, Anthropic, Azure, Gemini, VertexAI, etc.)
 - **Agent** (`src/agent/`): Framework for building AI agents that interact with users and perform tasks
 - **Store** (`src/store/`): Data storage abstraction with indexing and retrieval for vector databases
-- **MCP SDK** (`src/mcp-sdk/`): SDK for Model Context Protocol enabling agent-tool communication
 
 ### Integration Bundles
 - **AI Bundle** (`src/ai-bundle/`): Symfony integration for Platform, Store, and Agent components
-- **MCP Bundle** (`src/mcp-bundle/`): Symfony integration for MCP SDK
+- **MCP Bundle** (`src/mcp-bundle/`): Symfony integration for official MCP SDK
 
 ### Supporting Directories
 - **Examples** (`examples/`): Standalone examples demonstrating component usage across different AI platforms
@@ -92,7 +91,7 @@ symfony server:start
 Components are designed to work independently but have these relationships:
 - Agent depends on Platform for AI communication
 - AI Bundle integrates Platform, Agent, and Store
-- MCP Bundle provides MCP SDK integration
+- MCP Bundle provides official MCP SDK integration
 - Store is standalone but often used with Agent for RAG applications
 
 ## Testing Architecture

README.md

@@ -16,10 +16,9 @@ Symfony AI consists of several lower and higher level **components** and the res
   * **[Platform](src/platform/README.md)**: A unified interface to various AI platforms like OpenAI, Anthropic, Azure, Gemini, VertexAI, and more.
   * **[Agent](src/agent/README.md)**: Framework for building AI agents that can interact with users and perform tasks.
   * **[Store](src/store/README.md)**: Data storage abstraction with indexing and retrieval for AI applications.
-  * **[MCP SDK](src/mcp-sdk/README.md)**: SDK for [Model Context Protocol](https://modelcontextprotocol.io) enabling communication between AI agents and tools.
 * **Bundles**
   * **[AI Bundle](src/ai-bundle/README.md)**: Symfony integration for AI Platform, Store and Agent components.
-  * **[MCP Bundle](src/mcp-bundle/README.md)**: Symfony integration for MCP SDK, allowing them to act as MCP servers or clients.
+  * **[MCP Bundle](src/mcp-bundle/README.md)**: Symfony integration for official MCP SDK, allowing them to act as MCP servers or clients.
 
 ## Examples & Demo
 

demo/composer.json

@@ -23,6 +23,7 @@
         "symfony/flex": "^2.5",
         "symfony/framework-bundle": "~7.3.0",
         "symfony/http-client": "~7.3.0",
+        "mcp/sdk": "@dev",
         "symfony/mcp-bundle": "@dev",
         "symfony/monolog-bundle": "^3.10",
         "symfony/runtime": "~7.3.0",

demo/config/packages/mcp.yaml

@@ -1,5 +1,15 @@
 mcp:
     app: demo-app
     version: 0.0.1
+    pagination_limit: 10
+    instructions: |
+        This demo MCP server provides time management capabilities for developers.
+
+        Use this server when you need to work with timestamps, time zones, or time-based calculations.
+
     client_transports:
         stdio: true
+        http: true
+    http:
+        session:
+            store: file

demo/config/routes.yaml

@@ -49,3 +49,8 @@ stream:
 stream_assistant_reply:
     path: '/stream/assistant-reply'
     controller: 'App\Stream\TwigComponent::streamContent'
+
+# Load MCP routes conditionally based on configuration
+_mcp:
+    resource: .
+    type: mcp

demo/src/MCP/Prompts/CurrentTimePrompt.php

@@ -0,0 +1,28 @@
+<?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\Prompts;
+
+use Mcp\Capability\Attribute\McpPrompt;
+
+class CurrentTimePrompt
+{
+    #[McpPrompt(name: 'time-analysis')]
+    public function getTimeAnalysisPrompt(): array
+    {
+        return [
+            [
+                'role' => 'user',
+                'content' => 'You are a time management expert. Analyze what time of day it is and suggest appropriate activities for this time.',
+            ],
+        ];
+    }
+}

demo/src/MCP/ResourceTemplates/CurrentTimeResourceTemplate.php

@@ -0,0 +1,33 @@
+<?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\ResourceTemplates;
+
+use Mcp\Capability\Attribute\McpResourceTemplate;
+
+class CurrentTimeResourceTemplate
+{
+    #[McpResourceTemplate(uriTemplate: 'time://{timezone}', name: 'time-by-timezone')]
+    public function getTimeByTimezone(string $timezone): array
+    {
+        try {
+            $time = (new \DateTime('now', new \DateTimeZone($timezone)))->format('Y-m-d H:i:s T');
+        } catch (\Exception $e) {
+            $time = 'Invalid timezone: '.$timezone;
+        }
+
+        return [
+            'uri' => "time://$timezone",
+            'mimeType' => 'text/plain',
+            'text' => $time,
+        ];
+    }
+}

demo/src/MCP/Resources/CurrentTimeResource.php

@@ -0,0 +1,27 @@
+<?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\Resources;
+
+use Mcp\Capability\Attribute\McpResource;
+
+class CurrentTimeResource
+{
+    #[McpResource(uri: 'time://current', name: 'current-time-resource')]
+    public function getCurrentTimeResource(): array
+    {
+        return [
+            'uri' => 'time://current',
+            'mimeType' => 'text/plain',
+            'text' => (new \DateTime('now'))->format('Y-m-d H:i:s T'),
+        ];
+    }
+}