Merge branch 'klapaudius:master' into master

Author: trandbert37

.cursorrules

@@ -2,7 +2,7 @@ This is a packge for Symfony which makes easier to build a Model Context Protoco
 
 ## Technical Specification
 
-- Support Symfony 7
+- Support Symfony 6.4 and 7
 - Support PHP 8.2+
 
 ## Symfony Package Development Guideline

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [klapaudius]

.github/workflows/fix-php-code-style-issues.yml

@@ -22,9 +22,9 @@ jobs:
           ref: ${{ github.head_ref }}
 
       - name: Fix PHP code style issues
-        uses: aglipanci/laravel-pint-action@2.5
+        uses: aglipanci/laravel-pint-action@2.6
 
       - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           commit_message: Fix styling

.gitignore

@@ -31,3 +31,4 @@ testbench.yaml
 /coverage
 /phpunit.coverage.xml
 /docker/.env
+/docs/private/

.windsurfrules

@@ -2,7 +2,7 @@ This is a packge for Symfony which makes easier to build a Model Context Protoco
 
 ## Technical Specification
 
-- Support Symfony 7
+- Support Symfony 6.4 and 7
 - Support PHP 8.2+
 
 ## Symfony Package Development Guideline

CHANGELOG.md

@@ -1,3 +1,61 @@
+### Version 1.4.0
+- **Core Features:**
+  - Add comprehensive sampling support allowing tools to request LLM assistance during execution
+  - Introduce SamplingAwareToolInterface for tools that need to make nested LLM calls
+  - Add SamplingClient service for managing sampling requests
+  - Create example CodeAnalyzerTool demonstrating sampling usage
+- **Enhancements:**
+  - Automatic injection of SamplingClient into tools that implement SamplingAwareToolInterface
+  - Support for text and multi-message sampling requests
+  - Model preferences for controlling LLM selection (cost, speed, intelligence priorities)
+- **Bug Fixes:**
+  - #45 Rename "arguments" option to "inputs" in TestMcpPromptCommand and related files for consistency
+- **Documentation:**
+  - Add comprehensive sampling documentation with examples and best practices
+
+### Version 1.3.3
+- **Bug Fixes:**
+  - Protocol version negotiation incorrect (#41) by @Wolfgang-check24
+
+### Version 1.3.2
+- **Bug Fixes:**
+  - Fix protocol evaluation on client request (#38) by @Wolfgang-check24
+  - Fix SSE stream blocking issue (#36) by @Wolfgang-check24
+- **Enhancements:**
+  - Add test environment initialization and conditional output handling adjustments
+- **Documentation:**
+  - Move development guidelines to CONTRIBUTING.md
+
+### Version 1.3.1
+- **Enhancements:**
+  - Add Symfony 6.4 compliancy
+
+### Version 1.3.0
+
+- **Core Features:**
+  - Add comprehensive prompt system with multiple message types (Text, Image, Audio, Resource, Collection)
+  - Introduce MakeMcpPromptCommand for generating prompts via console
+  - Add TestMcpPromptCommand for testing prompt functionality
+  - Store client sampling capabilities for better client-server communication
+  - Add ProfileGeneratorTool and CollectionToolResult examples
+- **Enhancements:**
+   - Update documentation with prompts usage and testing commands
+- **Bug Fixes:**
+  - Remove unused `setAccessible` calls in tests
+  - Fix code styling issues
+         
+### Version 1.2.0
+
+- **Core Features:**
+  - Add real-time communication support through Streamable Http
+  - Add Streaming Tool Support
+  - Add TextToolResult, AudioToolResult, ImageToolResult and ResourceToolResult to properly manage tool returns
+  - Both SSE and StreamableHttp can be active that makes clients able to use the old protocol version
+- **Deprecations:**
+  - Configuration key `klp_mcp_server.server_provider` is replaced by `klp_mcp_server.server_providers` to maintain backward compatibility
+  for clients that does not support the `2025-03-26` protocol version yet.
+  - The ToolInterface is deprecated. Use StreamableToolInterface instead.
+
 ### Version 1.1.0
 
 - **Core Features:**

CLAUDE.md

@@ -0,0 +1,100 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Symfony bundle that enables developers to seamlessly add a Model Context Protocol (MCP) server to their Symfony applications. The main goal is to provide a production-ready implementation following the official MCP specifications at https://modelcontextprotocol.io/specification/2025-03-26.
+
+The bundle allows Symfony applications to expose tools, resources, and prompts that can be consumed by Large Language Models (LLMs) through secure transport protocols (SSE and StreamableHTTP), avoiding the security risks of STDIO transport in enterprise environments.
+
+## Commands
+
+### Testing
+```bash
+# Run all tests
+vendor/bin/phpunit
+
+# Run a specific test file
+vendor/bin/phpunit tests/path/to/TestFile.php
+
+# Generate code coverage
+vendor/bin/phpunit --coverage-html build/coverage
+
+# Run PHPStan static analysis
+vendor/bin/phpstan analyse
+```
+
+### Development Tools
+```bash
+# Create a new MCP tool
+php bin/console make:mcp-tool MyCustomTool
+
+# Test a specific MCP tool
+php bin/console mcp:test-tool MyCustomTool
+
+# Test tool with specific input
+php bin/console mcp:test-tool MyCustomTool --input='{"param":"value"}'
+
+# List all available tools
+php bin/console mcp:test-tool --list
+```
+
+### MCP Inspector
+```bash
+# Run the MCP Inspector for visual testing
+npx @modelcontextprotocol/inspector node build/index.js
+```
+
+## Architecture Overview
+
+### Package Structure
+This is a Symfony bundle that implements the Model Context Protocol (MCP) server. It provides:
+
+- **Dual Transport Support**: Both SSE (Server-Sent Events) and StreamableHTTP protocols
+- **Tool System**: Extensible framework for creating MCP tools that LLMs can invoke
+- **Resource System**: Management of resources that can be exposed to LLM clients
+- **Prompt System**: Pre-defined conversation starters and templates for LLM interactions
+- **Progress Notifications**: Real-time progress updates for long-running operations
+
+### Key Components
+
+#### Transport Layer
+- **SSE Transport**: Uses Server-Sent Events with a pub/sub pattern via adapters (Cache or Redis)
+- **StreamableHTTP Transport**: Direct HTTP-based communication supporting both streaming and non-streaming responses
+- **Adapter System**: Abstraction layer allowing different message brokers (Cache, Redis)
+
+#### Tool System
+- **BaseToolInterface**: Core interface for all tools (deprecated in favor of StreamableToolInterface)
+- **StreamableToolInterface**: Modern interface supporting progress notifications
+- **ToolResultInterface**: Abstraction for different result types (Text, Image, Audio, Resource)
+- **ProgressNotifier**: System for sending real-time progress updates during tool execution
+
+#### Prompt System
+- **PromptInterface**: Core interface for creating prompts
+- **PromptMessageInterface**: Base interface for different message types
+- **Message Types**: TextPromptMessage, ImagePromptMessage, AudioPromptMessage, ResourcePromptMessage
+- **CollectionPromptMessage**: Container for multiple prompt messages
+- **PromptRepository**: Manages and retrieves available prompts
+
+#### Request Handlers
+- Located in `src/Server/Request/`: Handle different MCP protocol methods
+- Each handler implements specific MCP operations (initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, etc.)
+
+#### Protocol Implementation
+- **MCPProtocol**: Core protocol implementation handling request/response flow
+- **RequestHandler/NotificationHandler**: Process different message types
+- **MCPServer**: Main server orchestrating all components
+
+### Configuration
+- Main config: `config/packages/klp_mcp_server.yaml`
+- Tools, resources, and prompts are registered in configuration
+- Supports multiple adapters for SSE transport
+
+## Important Notes
+
+- **Cannot use** `symfony server:start` - requires proper web server (Nginx/Apache + PHP-FPM) for concurrent connections
+- Tools should implement `StreamableToolInterface` for modern features
+- Progress notifications only work with streaming tools (`isStreaming()` returns true)
+- All types should use `string|null` syntax instead of `?string` (null at the end)
+- Follow PSR-12 coding standards and include PHPDoc for all public methods

docs/development_guidelines.md CONTRIBUTING.mddocs/development_guidelines.md renamed to CONTRIBUTING.md

@@ -6,7 +6,7 @@ This document provides essential information for developers working on the Symfo
 
 ### Prerequisites
 - PHP 8.2 or higher
-- Symfony 7.0
+- Symfony 6.4 or higher
 - Composer
 
 ### Installation
@@ -51,15 +51,16 @@ This document provides essential information for developers working on the Symfo
        ping:
            enabled: true
            interval: 30
-       server_provider: 'sse'
-       sse_adapter: 'redis'
+       server_providers: ['streamable_http', 'sse']  # Available options: 'sse', 'streamable_http'
+       sse_adapter: 'cache'
        adapters:
            redis:
                prefix: 'mcp_sse_'
                host: 'localhost'  # Change as needed
                ttl: 100
        tools:
            - KLP\KlpMcpServer\Services\ToolService\Examples\HelloWorldTool
+           - KLP\KlpMcpServer\Services\ToolService\Examples\StreamingDataTool
            - KLP\KlpMcpServer\Services\ToolService\Examples\VersionCheckTool
    ```
 
@@ -75,6 +76,9 @@ This document provides essential information for developers working on the Symfo
 - **Web Server**: This package cannot be used with `symfony server:start` as it requires processing multiple connections concurrently. Use Nginx + PHP-FPM, Apache + PHP-FPM, or a custom Docker setup instead.
 - **Redis Configuration**: Ensure your Redis server is properly configured and accessible at the host specified in the configuration.
 - **Security**: It's strongly recommended to implement OAuth2 Authentication for production use.
+- **Protocol Support**: This bundle supports two protocols:
+  - **SSE (Server-Sent Events)**: The legacy protocol for real-time communication.
+  - **StreamableHTTP**: The actual protocol that works over standard HTTP connection or Streaming if needed.
 
 ### Docker Setup
 
@@ -221,11 +225,11 @@ class DataUtilTest extends TestCase
    php bin/console make:mcp-tool MyCustomTool
    ```
 
-2. Implement the `ToolInterface` in your custom tool class:
+2. Implement the `StreamableToolInterface` in your custom tool class:
    ```php
-   use KLP\KlpMcpServer\Services\ToolService\ToolInterface;
+   use KLP\KlpMcpServer\Services\ToolService\StreamableToolInterface;
 
-   class MyCustomTool implements ToolInterface
+   class MyCustomTool implements StreamableToolInterface
    {
        // Implementation
    }
@@ -260,4 +264,6 @@ php bin/console mcp:test-tool MyCustomTool --input='{"param":"value"}'
 
 - The package implements a publish/subscribe (pub/sub) messaging pattern through its adapter system.
 - The default Redis adapter maintains message queues for each client, identified by unique client IDs.
-- Long-lived SSE connections subscribe to messages for their respective clients and deliver them in real-time.
+- The bundle supports two transport protocols:
+  - **SSE (Server-Sent Events)**: Long-lived connections that subscribe to messages for their respective clients and deliver them in real-time.
+  - **StreamableHTTP**: An HTTP-based protocol that can handle both streaming and non-streaming responses.

LICENSE.md

@@ -1,8 +1,8 @@
 The MIT License (MIT)
 
-Copyright (c) OP.GG
+Copyright (c) 2025 Boris AUBE
 
-Copyright (c) 2025 klapaudius
+Copyright (c) OP.GG
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal