Improve README documentation for tools, prompts, and resource management

- Added sections on creating and testing prompts and resources.
- Updated examples and usage instructions.
- Enhanced clarity, fixed typos, and restructured headings.
- Updated roadmap details and documentation links.

Author: klapaudius

README.md

@@ -8,8 +8,8 @@
 <a href="https://github.com/klapaudius/symfony-mcp-server/actions"><img src="https://github.com/klapaudius/symfony-mcp-server/actions/workflows/tests.yml/badge.svg" alt="Build Status"></a>
 <a href="https://codecov.io/gh/klapaudius/symfony-mcp-server" >  <img src="https://codecov.io/gh/klapaudius/symfony-mcp-server/graph/badge.svg?token=5FXOJVXPZ1" alt="Coverage"/></a>
 <a href="https://packagist.org/packages/klapaudius/symfony-mcp-server"><img src="https://img.shields.io/packagist/l/klapaudius/symfony-mcp-server" alt="License"></a>
+<a href="https://packagist.org/packages/klapaudius/symfony-mcp-server"><img src="https://img.shields.io/packagist/v/klapaudius/symfony-mcp-server" alt="Latest Stable Version"></a>
 
-[//]: # (<a href="https://packagist.org/packages/klapaudius/symfony-mcp-server"><img src="https://img.shields.io/packagist/v/klapaudius/symfony-mcp-server" alt="Latest Stable Version"></a>)
 [//]: # (<a href="https://packagist.org/packages/klapaudius/symfony-mcp-server"><img src="https://img.shields.io/packagist/dt/klapaudius/symfony-mcp-server" alt="Total Downloads"></a>)
 </p>
 
@@ -40,9 +40,9 @@ Key benefits:
 ## Key Features
 
 - Real-time communication support through StreamableHTTP and/or Server-Sent Events (SSE) integration
-- Implementation of tools and resources compliant with Model Context Protocol specifications
-- Support of streaming tools with progres notifications
-- Support different types of tool results such as Text, Image, Audio, or Resource
+- Implementation of tools, resources and prompts compliant with Model Context Protocol specifications
+- Support of streaming tools with progress notifications
+- Support different types of tool results such as Text, Image, Audio or Resource
 - Adapter-based design architecture with Pub/Sub messaging pattern
 
 ## Requirements
@@ -116,111 +116,122 @@ Enhance your application's security by implementing OAuth2 Authentication. You c
 
 ## Basic Usage
 
-### Creating and Adding Custom Tools
-
-The package provides convenient commands to generate new tools:
+### Creating and Adding Custom Tools or Prompts
 
+The package provides convenient commands 
+- to generate new tools:
 ```bash
 php bin/console make:mcp-tool MyCustomTool
 ```
+- to generate new prompts:
+```bash
+php bin/console make:mcp-prompt MyCustomPrompt
+```
 
-This command:
+Those commands:
 
 - Handles various input formats (spaces, hyphens, mixed case)
 - Automatically converts the name to the proper case format
-- Creates a properly structured tool class in `src/MCP/Tools`
-- Offers to automatically register the tool in your configuration
+- Creates a properly structured class in `src/MCP/Tools` or `src/MCP/Prompts`
+- Offers to automatically register items in your configuration (`config/packages/klp_mcp_server.yaml`)
 
-You can also manually create and register tools in `config/packages/klp_mcp_server.yaml`:
-
-```php
-use KLP\KlpMcpServer\Services\ProgressService\ProgressNotifierInterface;
-use KLP\KlpMcpServer\Services\ToolService\Annotation\ToolAnnotation;
-use KLP\KlpMcpServer\Services\ToolService\Result\ToolResultInterface;
-use KLP\KlpMcpServer\Services\ToolService\StreamableToolInterface;
-
-class MyCustomTool implements StreamableToolInterface
-{
-    // Tool implementation
-}
-```
-
-### Testing MCP Tools
+### Testing MCP Tools or Prompts
 
 The package includes a special command for testing your MCP tools without needing a real MCP client:
 
 ```bash
 # Test a specific tool interactively
 php bin/console mcp:test-tool MyCustomTool
 
+# Test a specific prompt interactively
+php bin/console mcp:test-prompt MyCustomPrompt
+
 # List all available tools
 php bin/console mcp:test-tool --list
 
+# List all available prompts
+php bin/console mcp:test-prompt --list
+
 # Test with specific JSON input
 php bin/console mcp:test-tool MyCustomTool --input='{"param1":"value"}'
+
+# Test with specific arguments
+php bin/console mcp:test-prompt MyCustomPrompt --arguments='{"topic":"AI","tone":"professional"}'
 ```
 
 This helps you rapidly develop and debug tools by:
 
-- Showing the tool's input schema and validating inputs
-- Executing the tool with your provided input
+- Showing the item's input schema and validating inputs
+- Executing the item with your provided input
 - Displaying formatted results or detailed error information
-- Displaying progress notifications for streaming tool
+- Displaying progress notifications for a streaming tool
 - Supporting complex input types including objects and arrays
 
-**For deep diving into tools creation please take a look at dedicated documentation [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_tools.md)**
+**For deep diving into tools creation: please take a look at dedicated documentation [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_tools.md)**
 
-### Creating and Adding Custom Prompts
+**For prompts creation: [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_prompts.md)**
 
-The package provides convenient commands to generate new prompts:
+## Resources
 
-```bash
-php bin/console make:mcp-prompt MyCustomPrompt
-```
+The package provides a flexible resource management system that allows you to store and retrieve resources from different providers (file system, database, etc.).
 
-This command:
+### Configuration
 
-- Handles various input formats (spaces, hyphens, mixed case)
-- Automatically converts the name to the proper kebab-case format
-- Creates a properly structured prompt class in `src/MCP/Prompts`
-- Offers to automatically register the prompt in your configuration
+Configure resources in your `config/packages/klp_mcp_server.yaml` file:
+
+```yaml
+klp_mcp_server:
+    # ...
+    resources:
+        - App\MCP\Resources\MyCustomResource
+    resources_templates:
+        - App\MCP\Resources\MyCustomResourceTemplate
+```
 
-You can also manually create and register prompts in `config/packages/klp_mcp_server.yaml`:
+### Usage
+
+### Creating Custom Resource
 
 ```php
-use KLP\KlpMcpServer\Services\PromptService\PromptInterface;
-use KLP\KlpMcpServer\Services\PromptService\Message\TextPromptMessage;
+use KLP\KlpMcpServer\Services\ResourceService\ResourceInterface;
 
-class MyCustomPrompt implements PromptInterface
+class MyCustomResource implements ResourceInterface
 {
-    // Prompt implementation
+    // Resource implementation
 }
 ```
+Then register your resource in the configuration:
 
-### Testing MCP Prompts
+```yaml
+klp_mcp_server:
+    # ...
+    resources:
+      - App\MCP\Resources\MyCustomResource
+```
 
-The package includes a command for testing your MCP prompts without needing a real MCP client:
+### Creating Custom Resource Template
 
-```bash
-# Test a specific prompt interactively
-php bin/console mcp:test-prompt MyCustomPrompt
+You can create custom resource templates by implementing the `ResourceTemplateInterface`:
 
-# List all available prompts
-php bin/console mcp:test-prompt --list
+```php
+use KLP\KlpMcpServer\Services\ResourceService\ResourceTemplateInterface;
 
-# Test with specific arguments
-php bin/console mcp:test-prompt MyCustomPrompt --arguments='{"topic":"AI","tone":"professional"}'
+class MyCustomResourceTemplate implements ResourceTemplateInterface
+{
+    // Implement the required methods
+}
 ```
 
-This helps you rapidly develop and debug prompts by:
+Then register your resource template in the configuration:
 
-- Showing the prompt's argument schema and validating inputs
-- Executing the prompt with your provided arguments
-- Displaying formatted message results with proper role assignments
-- Supporting complex argument types including objects and arrays
-- Demonstrating multi-modal content (text, images, audio, resources)
+```yaml
+klp_mcp_server:
+    # ...
+    resources_templates:
+      - App\MCP\Resources\MyCustomResourceTemplate
+```
 
-**For deep diving into prompts creation please take a look at dedicated documentation [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_prompts.md)**
+**For deep diving into resources' management, please take a look at dedicated documentation [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_resources.md)**
 
 ### Visualizing with Inspector
 
@@ -272,7 +283,6 @@ This architecture enables:
 
 A Redis adapter can be configured as follows:
 
-
 ```yaml
 klp_mcp_server:
     # ...
@@ -284,67 +294,15 @@ klp_mcp_server:
             ttl: 100            # Message TTL in seconds
 ```
 
-## Resources
-
-The package provides a flexible resource management system that allows you to store and retrieve resources from different providers (file system, database, etc.).
-
-### Configuration
-
-Configure resources in your `config/packages/klp_mcp_server.yaml` file:
-
-```yaml
-klp_mcp_server:
-    # ...
-    resources:
-        - App\MCP\Resources\MyCustomResource
-    resources_templates:
-        - App\MCP\Resources\MyCustomResourceTemplate
-```
-
-### Usage
-
-### Creating Custom Resource
-
-```php
-use KLP\KlpMcpServer\Services\ResourceService\ResourceInterface;
-
-class MyCustomResource implements ResourceInterface
-{
-    // Resource implementation
-}
-```
-Then register your resource in the configuration:
-
-```yaml
-klp_mcp_server:
-    # ...
-    resources:
-      - App\MCP\Resources\MyCustomResource
-```
-
-### Creating Custom Resource Template
+## Roadmap
 
-You can create custom resource templates by implementing the `ResourceTemplateInterface`:
+Our development roadmap outlines the planned enhancements and features for upcoming releases:
 
-```php
-use KLP\KlpMcpServer\Services\ResourceService\ResourceTemplateInterface;
+- **Enhanced Protocol Support**: Continued improvements to StreamableHTTP implementation and stay up to date with newer specifications
+- **Sampling Feature Implementation**: Taking advantage of Client's Sampling Capability
 
-class MyCustomResourceTemplate implements ResourceTemplateInterface
-{
-    // Implement the required methods
-}
-```
-
-Then register your resource template in the configuration:
-
-```yaml
-klp_mcp_server:
-    # ...
-    resources_templates:
-      - App\MCP\Resources\MyCustomResourceTemplate
-```
-
-**For deep diving into resources' management, please take a look at dedicated documentation [Here](https://github.com/klapaudius/symfony-mcp-server/blob/master/docs/building_resources.md)**
+For detailed discussions about upcoming features and to contribute your ideas, please visit the [Discussion section](https://github.com/klapaudius/symfony-mcp-server/discussions).
+Community feedback plays a crucial role in shaping our development priorities.
 
 ## MCP Registries referencing
 https://mcpreview.com/mcp-servers/klapaudius/symfony-mcp-server