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

- Replace symfony/mcp-sdk dependency with official mcp/sdk
- Refactor Server creation to use Server::make() builder pattern
- Convert tool definitions from interfaces to #[McpTool] attributes
- Implement automatic tool discovery in src/ directory
- Update STDIO transport command to mcp:server
- Simplify service configuration using native SDK patterns
- Remove redundant ServerFactory and routes.php files
- Add custom LogicException for bundle-specific errors
- Update all documentation (README, CHANGELOG, index.rst)
- Fix composer.json description
- Add .idea/ to .gitignore

Resolves #526

Fabbot + php-cs-fixer

DOCtor-RST

 Fix RouteLoader registration to always create when transports enabled

Remove .idea

  - Add autoconfiguration for #[McpTool] attribute with mcp.tool tag
  - Create McpToolPass compiler pass using ServiceLocatorTagPass::register()
  - Inject Service Locator into ServerBuilder via setContainer()

Fix PR review comments for MCP Bundle migration

- Remove prefer-stable from root composer.json
- Move CHANGELOG content to 0.1 section and remove BC BREAK labels
- Use ServerBuilder::class and Server::class in services configuration
- Fix "client vs server" comment in documentation
- Use ServerBuilder::class in test instead of string

Remove symfony/mcp-sdk

Remove symfony/mcp-sdk ref in claude reamdde et phpstan

Rewrite CHANGELOG.md

Use [] === $taggedServices instead of empty($taggedServices)

Use use Symfony\Component\Routing\Exception\LogicException; instead of custom Exception

Add MCP capabilities support to Symfony bundle

This commit implements Model Context Protocol (MCP) support by adding:

- Prompts: System instructions for AI context using #[McpPrompt]
- Resources: Static data access using #[McpResource]
- Resource Templates: Dynamic resources with parameters using #[McpResourceTemplate]

Implementation includes:
- Auto-configuration for MCP attributes with proper tagging
- Compiler passes extending AbstractMcpPass for service registration
- Documentation updates with examples and usage patterns
- Demo examples showcasing each capability type

Technical details:
- Refactored auto-configuration into registerMcpAttributes() method
- Created AbstractMcpPass to eliminate code duplication
- Added proper error handling for timezone validation
- Resource Templates ready but await MCP SDK handler implementation

Apply PHP CS Fixer to demo MCP examples

- Add Symfony license headers to demo files
- Fix code style and formatting
- Add trailing commas where appropriate

Add pagination_limit and instructions configuration options

- Add pagination_limit option to control MCP list responses (default: 50)
- Add instructions option for server description to help LLMs
- Update services.php to pass both options to ServerBuilder
- Add comprehensive tests for new configuration options
- Update documentation with examples and usage
- Update demo configuration with practical examples

Both options map directly to ServerBuilder methods:
- setPaginationLimit(int)
- setInstructions(string)

Add dedicated MCP logger with configurable Monolog integration

- Create monolog.logger.mcp service with dedicated channel
- Update ServerBuilder to use MCP-specific logger instead of generic logger
- Add comprehensive logging documentation with configuration examples
- Include examples for different environments (dev/prod) and handlers (file/Slack)
- Add test coverage for MCP logger service creation and configuration

The MCP logger uses Monolog's logger prototype pattern and can be customized
by users through standard Monolog configuration in their applications.

  Add EventDispatcher support and event system documentation

  - Configure Symfony EventDispatcher for MCP SDK event handling
  - Add comprehensive event system documentation with examples
  - Add test coverage for EventDispatcher configuration
  - Fix PHPStan type assertion for ChildDefinition

Migrate MCP Bundle from SSE to official StreamableHttpTransport

- Replace custom SSE implementation with MCP SDK's StreamableHttpTransport
- Change sse transport to http in configuration and code
- Simplify DependencyInjection compiler passes
- Add HTTP session management (file/memory store options)
- Update documentation and tests for HTTP transport

Author: camilleislasse

.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'),
+        ];
+    }
+}