Add test command and server disable option for MCP tools

Author: kargnas

README.md

@@ -92,6 +92,28 @@ class MyCustomTool implements ToolInterface
 }
 ```
 
+### Testing MCP Tools
+
+The package includes a special command for testing your MCP tools without needing a real MCP client:
+
+```bash
+# Test a specific tool interactively
+php artisan mcp:test-tool MyCustomTool
+
+# List all available tools
+php artisan mcp:test-tool --list
+
+# Test with specific JSON input
+php artisan mcp:test-tool MyCustomTool --input='{"param":"value"}'
+```
+
+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
+- Displaying formatted results or detailed error information
+- Supporting complex input types including objects and arrays
+
 ## Advanced Features
 
 ### Pub/Sub Architecture with SSE Adapters
@@ -126,6 +148,25 @@ The default Redis adapter can be configured as follows:
 ],
 ```
 
+## Environment Variables
+
+The package supports the following environment variables to allow configuration without modifying the config files:
+
+| Variable | Description | Default |
+|----------|-------------|--------|
+| `MCP_SERVER_ENABLED` | Enable or disable the MCP server | `true` |
+| `MCP_REDIS_CONNECTION` | Redis connection name from database.php | `default` |
+
+### Example .env Configuration
+
+```
+# Disable MCP server in specific environments
+MCP_SERVER_ENABLED=false
+
+# Use a specific Redis connection for MCP
+MCP_REDIS_CONNECTION=mcp
+```
+
 ## License
 
 This project is distributed under the MIT license.

config/mcp-server.php

@@ -1,6 +1,17 @@
 <?php
 
 return [
+    /*
+    |--------------------------------------------------------------------------
+    | MCP Server Activation
+    |--------------------------------------------------------------------------
+    |
+    | Enable or disable the MCP server functionality. When disabled, no routes
+    | will be registered and the server will not respond to any requests.
+    |
+    */
+    'enabled' => env('MCP_SERVER_ENABLED', true),
+
     /*
     |--------------------------------------------------------------------------
     | Server Information
@@ -46,9 +57,7 @@
     | Server-Sent Events Provider
     |--------------------------------------------------------------------------
     |
-    | When set to true, the MCPServer will be registered as a singleton in the
-    | application container. This allows for easy access to the server instance
-    | throughout the application when using the SSE transport.
+    | The type of server provider to use. Currently only 'sse' is supported.
     |
     */
     'server_provider' => 'sse',

src/Console/Commands/MakeMcpToolCommand.php

@@ -79,6 +79,13 @@ public function handle()
             $this->comment("        {$fullClassName}::class,");
             $this->comment("    ],");
         }
+        
+        // Display testing instructions
+        $this->newLine();
+        $this->info("You can now test your tool with the following command:");
+        $this->comment("    php artisan mcp:test-tool " . $className);
+        $this->info("Or view all available tools:");
+        $this->comment("    php artisan mcp:test-tool --list");
 
         return 0;
     }