fix: adding generator commands

Author: binaryk

docs-v2/content/en/mcp/mcp.md

@@ -325,10 +325,26 @@ protected function discoverTools(): array
         }
     }
 
+    // Auto-discover tools from app/Restify/Mcp/Tools
+    $appToolsPath = app_path('Restify/Mcp/Tools');
+    if (is_dir($appToolsPath)) {
+        $appToolDir = new \DirectoryIterator($appToolsPath);
+        foreach ($appToolDir as $toolFile) {
+            if ($toolFile->isFile() && $toolFile->getExtension() === 'php') {
+                $fqdn = 'App\\Restify\\Mcp\\Tools\\'.$toolFile->getBasename('.php');
+                if (class_exists($fqdn) && ! in_array($fqdn, $excludedTools, true)) {
+                    $this->addTool($fqdn);
+                }
+            }
+        }
+    }
+    
     return $this->registeredTools;
 }
 ```
 
+**Auto-Discovery from Application Directory**: The MCP server automatically discovers and registers tools from your application's `app/Restify/Mcp/Tools` directory. Any tool class placed in this directory will be automatically registered without requiring manual configuration.
+
 ### Configuration Options
 
 You can control tool discovery through configuration:

src/Commands/McpResourceCommand.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace Binaryk\LaravelRestify\Commands;
+
+use Illuminate\Console\ConfirmableTrait;
+use Illuminate\Console\GeneratorCommand;
+use Illuminate\Support\Str;
+
+class McpResourceCommand extends GeneratorCommand
+{
+    use ConfirmableTrait;
+
+    protected $name = 'restify:mcp-resource';
+
+    protected $description = 'Create a new MCP resource class';
+
+    protected $type = 'Resource';
+
+    public function handle()
+    {
+        if (parent::handle() === false && ! $this->option('force')) {
+            return false;
+        }
+    }
+
+    /**
+     * Build the class with the given name.
+     * This method should return the file class content.
+     *
+     * @param  string  $name
+     * @return string
+     *
+     * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
+     */
+    protected function buildClass($name)
+    {
+        if (Str::endsWith($name, 'Resource') === false) {
+            $name .= 'Resource';
+        }
+
+        return parent::buildClass($name);
+    }
+
+    protected function getStub()
+    {
+        return __DIR__.'/stubs/mcp-resource.stub';
+    }
+
+    protected function getPath($name)
+    {
+        if (Str::endsWith($name, 'Resource') === false) {
+            $name .= 'Resource';
+        }
+
+        return parent::getPath($name);
+    }
+
+    protected function getDefaultNamespace($rootNamespace)
+    {
+        return $rootNamespace.'\\Restify\\Mcp\\Resources';
+    }
+}

src/Commands/ToolCommand.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace Binaryk\LaravelRestify\Commands;
+
+use Illuminate\Console\ConfirmableTrait;
+use Illuminate\Console\GeneratorCommand;
+use Illuminate\Support\Str;
+
+class ToolCommand extends GeneratorCommand
+{
+    use ConfirmableTrait;
+
+    protected $name = 'restify:mcp-tool';
+
+    protected $description = 'Create a new MCP tool class';
+
+    protected $type = 'Tool';
+
+    public function handle()
+    {
+        if (parent::handle() === false && ! $this->option('force')) {
+            return false;
+        }
+    }
+
+    /**
+     * Build the class with the given name.
+     * This method should return the file class content.
+     *
+     * @param  string  $name
+     * @return string
+     *
+     * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
+     */
+    protected function buildClass($name)
+    {
+        if (Str::endsWith($name, 'Tool') === false) {
+            $name .= 'Tool';
+        }
+
+        $stub = parent::buildClass($name);
+
+        // Replace the tool name placeholder with a kebab-case version of the class name
+        $toolName = Str::kebab(Str::beforeLast(class_basename($name), 'Tool'));
+        $stub = str_replace('DummyToolName', $toolName, $stub);
+
+        return $stub;
+    }
+
+    protected function getStub()
+    {
+        return __DIR__.'/stubs/mcp-tool.stub';
+    }
+
+    protected function getPath($name)
+    {
+        if (Str::endsWith($name, 'Tool') === false) {
+            $name .= 'Tool';
+        }
+
+        return parent::getPath($name);
+    }
+
+    protected function getDefaultNamespace($rootNamespace)
+    {
+        return $rootNamespace.'\\Restify\\Mcp\\Tools';
+    }
+}

src/Commands/stubs/mcp-resource.stub

@@ -0,0 +1,27 @@
+<?php
+
+namespace DummyNamespace;
+
+use Laravel\Mcp\Server\Contracts\Resources\Content;
+use Laravel\Mcp\Server\Resource;
+
+class DummyClass extends Resource
+{
+    public function description(): string
+    {
+        return 'Description of what this resource provides';
+    }
+
+    public function read(): string|Content
+    {
+        // Return the resource content as a string or Content object
+        // This can be JSON, text, or any other format
+        
+        $data = [
+            'example' => 'This is example data',
+            'timestamp' => now()->toIso8601String(),
+        ];
+
+        return json_encode($data, JSON_PRETTY_PRINT);
+    }
+}

src/Commands/stubs/mcp-tool.stub

@@ -0,0 +1,43 @@
+<?php
+
+namespace DummyNamespace;
+
+use Generator;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\ToolInputSchema;
+use Laravel\Mcp\Server\Tools\ToolResult;
+
+class DummyClass extends Tool
+{
+    public function name(): string
+    {
+        return 'DummyToolName';
+    }
+
+    public function description(): string
+    {
+        return 'Description of what this tool does';
+    }
+
+    public function schema(ToolInputSchema $schema): ToolInputSchema
+    {
+        // Define your tool's input parameters here
+        // Example:
+        // $schema->string('input')
+        //     ->description('The input parameter')
+        //     ->required();
+
+        return $schema;
+    }
+
+    public function handle(array $arguments): ToolResult|Generator
+    {
+        // Implement your tool's logic here
+        // Access input parameters via $arguments array
+        
+        return ToolResult::json([
+            'success' => true,
+            'message' => 'Tool executed successfully',
+        ]);
+    }
+}

src/LaravelRestifyServiceProvider.php

@@ -7,6 +7,7 @@
 use Binaryk\LaravelRestify\Commands\DevCommand;
 use Binaryk\LaravelRestify\Commands\FilterCommand;
 use Binaryk\LaravelRestify\Commands\GetterCommand;
+use Binaryk\LaravelRestify\Commands\McpResourceCommand;
 use Binaryk\LaravelRestify\Commands\PolicyCommand;
 use Binaryk\LaravelRestify\Commands\PrepareSanctumCommand;
 use Binaryk\LaravelRestify\Commands\PublishAuthCommand;
@@ -17,6 +18,7 @@
 use Binaryk\LaravelRestify\Commands\SetupCommand;
 use Binaryk\LaravelRestify\Commands\StoreCommand;
 use Binaryk\LaravelRestify\Commands\StubCommand;
+use Binaryk\LaravelRestify\Commands\ToolCommand;
 use Binaryk\LaravelRestify\Repositories\Repository;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
@@ -46,6 +48,8 @@ public function configurePackage(Package $package): void
                 RestifyRouteListCommand::class,
                 PrepareSanctumCommand::class,
                 SetupAuthCommand::class,
+                ToolCommand::class,
+                McpResourceCommand::class,
             ]);
     }
 

src/MCP/RestifyServer.php

@@ -63,6 +63,20 @@ protected function discoverTools(): array
             }
         }
 
+        // Auto-discover tools from app/Restify/Mcp/Tools
+        $appToolsPath = app_path('Restify/Mcp/Tools');
+        if (is_dir($appToolsPath)) {
+            $appToolDir = new \DirectoryIterator($appToolsPath);
+            foreach ($appToolDir as $toolFile) {
+                if ($toolFile->isFile() && $toolFile->getExtension() === 'php') {
+                    $fqdn = 'App\\Restify\\Mcp\\Tools\\'.$toolFile->getBasename('.php');
+                    if (class_exists($fqdn) && ! in_array($fqdn, $excludedTools, true)) {
+                        $this->addTool($fqdn);
+                    }
+                }
+            }
+        }
+
         $extraTools = config('restify.mcp.tools.include', []);
         foreach ($extraTools as $toolClass) {
             if (class_exists($toolClass)) {
@@ -158,6 +172,20 @@ protected function discoverResources(): array
             }
         }
 
+        // Auto-discover resources from app/Restify/Mcp/Resources
+        $appResourcesPath = app_path('Restify/Mcp/Resources');
+        if (is_dir($appResourcesPath)) {
+            $appResourceDir = new \DirectoryIterator($appResourcesPath);
+            foreach ($appResourceDir as $resourceFile) {
+                if ($resourceFile->isFile() && $resourceFile->getExtension() === 'php') {
+                    $fqdn = 'App\\Restify\\Mcp\\Resources\\'.$resourceFile->getBasename('.php');
+                    if (class_exists($fqdn) && ! in_array($fqdn, $excludedResources, true)) {
+                        $this->addResource($fqdn);
+                    }
+                }
+            }
+        }
+
         $extraResources = config('restify.mcp.resources.include', []);
         foreach ($extraResources as $resourceClass) {
             if (class_exists($resourceClass)) {