Add Support For Resource Templates

[pushpak1300]

Resolves #69

This PR introduces support for ResourceTemplate using an interface based approach. The earlier implementation required extending a dedicated ResourceTemplate class, which added extra structure that was not really necessary. With this update, URI template support becomes an optional capability that any resource can opt into by implementing a small interface.

Usage

use Laravel\Mcp\Server\Contracts\SupportsURITemplate;
use Laravel\Mcp\Server\Resource;
use Laravel\Mcp\Support\UriTemplate;

class UserFileResource extends Resource implements SupportsURITemplate
{
    protected string $mimeType = 'text/plain';

    protected string $description = 'Access user files by ID';

    public function uriTemplate(): UriTemplate
    {
        return new UriTemplate('file://users/{userId}/files/{fileId}');
    }

    public function handle(Request $request): Response
    { 
        $userId = $request->get('userId');
        $fileId = $request->get('fileId');
        $uri = $request->uri();

        return Response::text("User $userId, File $fileId");
    }
}

URI Template

Why Simplified

The MCP spec references RFC 6570 for URI template behavior, but full RFC support is more than what MCP resources typically need. This intentionally implements a simpler subset. The approach mirrors what the official PHP MCP SDK docs here, and we followed the same interpretation.

Supported

• Simple placeholders like {variable}
• Multiple variables in a path such as {var1}/{var2}
• Variables match a single path segment
• Alphanumeric variable names

new UriTemplate('file://users/{userId}');
new UriTemplate('file://users/{userId}/files/{fileId}');
new UriTemplate('https://api.example.com/{version}/{resource}/{id}');

Not Supported

• {+var}
• {#var}
• {.var}
• {/var}
• {?q,limit}
• {&page}
• {var*}

Important

Variables cannot span across multiple path segments.

// Valid
$template = new UriTemplate('file://files/{filename}');
$template->match('file://files/document.txt'); // returns ['filename' => 'document.txt']
// Not valid
$template->match('file://files/folder/document.txt'); // returns null

[joetannenbaum]

Looks good! Some minor changes, thanks Pushpak.

[taylorotwell]

Renamed interface to HasUriTemplate. Got rid of separate console command as it feels like if anything it should just be a flag of existing make:resource command.