✨ Add OAuth functionality, MCP tools, and feature tests

- 🔒 Added migrations for `oauth_access_tokens`, `oauth_refresh_tokens`, `oauth_auth_codes`, `oauth_clients`, and `oauth_device_codes`. - 🤖 Created MCP tools (Meetups, Cities, Venues, Courses, Lecturers) for managing entities with authentication and validation. - 🛠️ Implemented Passport-backed OAuth API guard configuration and validation endpoints. - ✅ Added comprehensive feature tests for MCP tools and OAuth functionality (access control, validation, and token-based authentication).
2026-06-16 16:20:30 +00:00 · 2026-06-08 09:37:00 +02:00
parent 3cad5f5636
commit d0544bfac9
67 changed files with 3948 additions and 83 deletions
@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Mcp\Tools\Search;
+
+use App\Models\Country;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\JsonSchema\Types\Type;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\Response;
+use Laravel\Mcp\Server\Attributes\Description;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+#[Description('Listet Länder (öffentlich) und liefert id, name und code (Ländercode), alphabetisch sortiert, begrenzt auf 10 Einträge. Jedes Land enthält zusätzlich eine flag (SVG-URL). Dient zum Auflösen von country_id.')]
+class ListCountriesTool extends Tool
+{
+    public function handle(Request $request): Response
+    {
+        $search = $request->get('search');
+
+        $countries = Country::query()
+            ->select('id', 'name', 'code')
+            ->orderBy('name')
+            ->when(
+                $search,
+                fn (Builder $query) => $query
+                    ->where('name', 'ilike', "%{$search}%")
+                    ->orWhere('code', 'ilike', "%{$search}%"),
+            )
+            ->limit(10)
+            ->get()
+            ->map(function (Country $country) {
+                $country->flag = asset('vendor/blade-country-flags/4x3-'.$country->code.'.svg');
+
+                return $country;
+            });
+
+        return Response::json($countries->values());
+    }
+
+    /**
+     * @return array<string, Type>
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'search' => $schema->string()->description('Suche in Name oder Code (Ländercode).'),
+        ];
+    }
+}
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Mcp\Tools\Search;
+
+use App\Models\City;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\JsonSchema\Types\Type;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\Response;
+use Laravel\Mcp\Server\Attributes\Description;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+#[Description('Sucht Städte (öffentlich) und liefert id, name und das zugehörige Land, alphabetisch sortiert, begrenzt auf 10 Einträge. Dient zum Auflösen von city_id vor dem Anlegen von Datensätzen.')]
+class SearchCitiesTool extends Tool
+{
+    public function handle(Request $request): Response
+    {
+        $search = $request->get('search');
+
+        $cities = City::query()
+            ->with(['country:id,name'])
+            ->select('id', 'name', 'country_id')
+            ->orderBy('name')
+            ->when(
+                $search,
+                fn (Builder $query) => $query
+                    ->where('name', 'ilike', "%{$search}%")
+            )
+            ->limit(10)
+            ->get();
+
+        return Response::json($cities->values());
+    }
+
+    /**
+     * @return array<string, Type>
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'search' => $schema->string()->description('Teilstring-Suche im Namen der Stadt.'),
+        ];
+    }
+}
@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Mcp\Tools\Search;
+
+use App\Models\Course;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\JsonSchema\Types\Type;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\Response;
+use Laravel\Mcp\Server\Attributes\Description;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+#[Description('Sucht Kurse (öffentlich) und liefert id und name, alphabetisch sortiert, begrenzt auf 10 Einträge. Jeder Kurs enthält zusätzlich ein image (Logo-Thumbnail-URL). Optional nach Ersteller (user_id) filterbar. Dient zum Auflösen von course_id.')]
+class SearchCoursesTool extends Tool
+{
+    public function handle(Request $request): Response
+    {
+        $search = $request->get('search');
+        $userId = $request->get('user_id');
+
+        $courses = Course::query()
+            ->select('id', 'name')
+            ->orderBy('name')
+            ->when($userId !== null,
+                fn (Builder $query) => $query->where('created_by', (int) $userId))
+            ->when(
+                $search,
+                fn (Builder $query) => $query
+                    ->where('name', 'ilike', "%{$search}%")
+            )
+            ->limit(10)
+            ->get()
+            ->map(function (Course $course) {
+                $course->image = $course->getFirstMediaUrl('logo',
+                    'thumb');
+
+                return $course;
+            });
+
+        return Response::json($courses->values());
+    }
+
+    /**
+     * @return array<string, Type>
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'search' => $schema->string()->description('Teilstring-Suche im Namen des Kurses.'),
+            'user_id' => $schema->integer()->description('Filtert die Kurse nach ihrem Ersteller.'),
+        ];
+    }
+}
@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Mcp\Tools\Search;
+
+use App\Models\Lecturer;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\JsonSchema\Types\Type;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\Response;
+use Laravel\Mcp\Server\Attributes\Description;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+#[Description('Sucht Referenten (öffentlich) und liefert id und name, alphabetisch sortiert, begrenzt auf 10 Einträge. Jeder Referent enthält zusätzlich ein image (Avatar-Thumbnail-URL). Dient zum Auflösen von lecturer_id.')]
+class SearchLecturersTool extends Tool
+{
+    public function handle(Request $request): Response
+    {
+        $search = $request->get('search');
+
+        $lecturers = Lecturer::query()
+            ->select('id', 'name')
+            ->orderBy('name')
+            ->when(
+                $search,
+                fn (Builder $query) => $query
+                    ->where('name', 'ilike', "%{$search}%")
+            )
+            ->limit(10)
+            ->get()
+            ->map(function (Lecturer $lecturer) {
+                $lecturer->image = $lecturer->getFirstMediaUrl('avatar',
+                    'thumb');
+
+                return $lecturer;
+            });
+
+        return Response::json($lecturers->values());
+    }
+
+    /**
+     * @return array<string, Type>
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'search' => $schema->string()->description('Teilstring-Suche im Namen.'),
+        ];
+    }
+}
@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Mcp\Tools\Search;
+
+use App\Models\Venue;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\JsonSchema\Types\Type;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\Response;
+use Laravel\Mcp\Server\Attributes\Description;
+use Laravel\Mcp\Server\Tool;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+#[Description('Sucht Veranstaltungsorte (öffentlich) und liefert id, name sowie die zugehörige Stadt/Land, alphabetisch sortiert, begrenzt auf 10 Einträge. Jeder Ort enthält zusätzlich flag (SVG-URL der Landesflagge) und description (Stadt + Straße). Dient zum Auflösen von venue_id.')]
+class SearchVenuesTool extends Tool
+{
+    public function handle(Request $request): Response
+    {
+        $search = $request->get('search');
+
+        $venues = Venue::query()
+            ->with(['city:id,name,country_id', 'city.country:id,name,code'])
+            ->select('id', 'name', 'city_id')
+            ->orderBy('name')
+            ->when(
+                $search,
+                fn (Builder $query) => $query
+                    ->where('name', 'ilike', "%{$search}%")
+            )
+            ->limit(10)
+            ->get()
+            ->map(function (Venue $venue) {
+                $venue->flag = asset('vendor/blade-country-flags/4x3-'.$venue->city->country->code.'.svg');
+                $venue->description = $venue->city->name.', '.$venue->street;
+
+                return $venue;
+            });
+
+        return Response::json($venues->values());
+    }
+
+    /**
+     * @return array<string, Type>
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'search' => $schema->string()->description('Teilstring-Suche im Namen des Veranstaltungsortes.'),
+        ];
+    }
+}