mcps and skills

2026-08-11 00:42:46 +03:00
parent 6ffb24f20a
commit 4e67077e12
44 changed files with 2158 additions and 0 deletions
@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\StoreMcpServerRequest;
+use App\Http\Requests\UpdateMcpServerRequest;
+use App\Http\Resources\McpServerResource;
+use App\Models\McpServer;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Http\Response;
+
+class McpServerController extends Controller
+{
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        $servers = McpServer::query()
+            ->with('user')
+            ->when($request->string('category')->toString(), fn ($query, $category) => $query->where('category', $category))
+            ->when($request->has('approved'), fn ($query) => $query->where('approved', $request->boolean('approved')))
+            ->latest('created_at')
+            ->paginate(20);
+
+        return McpServerResource::collection($servers);
+    }
+
+    public function store(StoreMcpServerRequest $request): McpServerResource
+    {
+        $server = McpServer::query()->create([
+            'featured' => false,
+            'approved' => false,
+            ...$request->validated(),
+            'user_id' => $request->user()->id,
+        ]);
+
+        return new McpServerResource($server->refresh()->load('user'));
+    }
+
+    public function show(McpServer $mcpServer): McpServerResource
+    {
+        return new McpServerResource($mcpServer->load('user'));
+    }
+
+    public function update(UpdateMcpServerRequest $request, McpServer $mcpServer): McpServerResource
+    {
+        $mcpServer->update($request->validated());
+
+        return new McpServerResource($mcpServer->load('user'));
+    }
+
+    public function destroy(McpServer $mcpServer): Response
+    {
+        $mcpServer->delete();
+
+        return response()->noContent();
+    }
+}
@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\StoreSkillRequest;
+use App\Http\Requests\UpdateSkillRequest;
+use App\Http\Resources\SkillResource;
+use App\Models\Skill;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Http\Response;
+
+class SkillController extends Controller
+{
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        $skills = Skill::query()
+            ->with('user')
+            ->when($request->string('category')->toString(), fn ($query, $category) => $query->where('category', $category))
+            ->when($request->has('approved'), fn ($query) => $query->where('approved', $request->boolean('approved')))
+            ->latest('created_at')
+            ->paginate(20);
+
+        return SkillResource::collection($skills);
+    }
+
+    public function store(StoreSkillRequest $request): SkillResource
+    {
+        $skill = Skill::query()->create([
+            'featured' => false,
+            'approved' => false,
+            ...$request->validated(),
+            'user_id' => $request->user()->id,
+        ]);
+
+        return new SkillResource($skill->refresh()->load('user'));
+    }
+
+    public function show(Skill $skill): SkillResource
+    {
+        return new SkillResource($skill->load('user'));
+    }
+
+    public function update(UpdateSkillRequest $request, Skill $skill): SkillResource
+    {
+        $skill->update($request->validated());
+
+        return new SkillResource($skill->load('user'));
+    }
+
+    public function destroy(Skill $skill): Response
+    {
+        $skill->delete();
+
+        return response()->noContent();
+    }
+}
@@ -0,0 +1,103 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\McpServer;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+class McpServerController extends Controller
+{
+    public function index(Request $request): View
+    {
+        $category = $request->string('category')->toString();
+        $search = $request->string('q')->toString();
+
+        $servers = McpServer::approved()
+            ->when($category, fn ($query) => $query->where('category', $category))
+            ->when($search, fn ($query) => $query->where('name', 'like', "%{$search}%"))
+            ->orderByDesc('featured')
+            ->orderByDesc('views')
+            ->paginate(12)
+            ->withQueryString();
+
+        return view('mcp-servers.index', [
+            'servers' => $servers,
+            'categories' => config('mcp_servers.categories'),
+            'activeCategory' => $category,
+            'search' => $search,
+            'title' => 'MCP Servers Directory — '.config('app.name'),
+            'description' => 'Discover Model Context Protocol servers, with docs, install instructions, and config examples.',
+            'canonical' => route('mcp-servers.index'),
+        ]);
+    }
+
+    public function category(string $category): View
+    {
+        abort_unless(array_key_exists($category, config('mcp_servers.categories')), 404);
+
+        $servers = McpServer::approved()
+            ->where('category', $category)
+            ->orderByDesc('featured')
+            ->orderByDesc('views')
+            ->paginate(12);
+
+        $label = config("mcp_servers.categories.{$category}");
+
+        return view('mcp-servers.category', [
+            'servers' => $servers,
+            'categories' => config('mcp_servers.categories'),
+            'category' => $category,
+            'label' => $label,
+            'title' => $label.' MCP Servers — '.config('app.name'),
+            'description' => "MCP servers for {$label}.",
+            'canonical' => route('mcp-servers.category', $category),
+        ]);
+    }
+
+    public function show(McpServer $mcpServer): View
+    {
+        abort_unless($mcpServer->approved, 404);
+
+        $mcpServer->increment('views');
+
+        $related = McpServer::approved()
+            ->where('category', $mcpServer->category)
+            ->whereKeyNot($mcpServer->id)
+            ->limit(4)
+            ->get();
+
+        return view('mcp-servers.show', [
+            'server' => $mcpServer,
+            'related' => $related,
+            'title' => $mcpServer->name.' — MCP Servers — '.config('app.name'),
+            'description' => $this->metaDescription($mcpServer->description),
+            'canonical' => route('mcp-servers.show', $mcpServer),
+            'image' => $mcpServer->logo_url,
+        ]);
+    }
+
+    public function visit(McpServer $mcpServer): RedirectResponse
+    {
+        abort_unless($mcpServer->approved, 404);
+
+        $mcpServer->increment('clicks');
+
+        return redirect()->away($mcpServer->url);
+    }
+
+    /**
+     * Truncate to ~155 chars without cutting a word in half. Google appends
+     * its own ellipsis when it truncates in search results, so we don't add one.
+     */
+    private function metaDescription(string $description, int $limit = 155): string
+    {
+        if (Str::length($description) <= $limit) {
+            return $description;
+        }
+
+        return Str::of($description)->limit($limit, '')->beforeLast(' ')->toString();
+    }
+}
@@ -3,8 +3,10 @@
 namespace App\Http\Controllers;

 use App\Models\Category;
+use App\Models\McpServer;
 use App\Models\Page;
 use App\Models\Post;
+use App\Models\Skill;
 use App\Models\Tag;
 use App\Models\Tool;
 use Illuminate\Http\Response;
@@ -18,6 +20,10 @@ class SitemapController extends Controller
        $tags = Tag::all(['slug', 'updated_at']);
        $tools = Tool::approved()->get(['slug', 'updated_at']);
        $toolCategories = array_keys(config('tools.categories'));
+        $mcpServers = McpServer::approved()->get(['slug', 'updated_at']);
+        $mcpServerCategories = array_keys(config('mcp_servers.categories'));
+        $skills = Skill::approved()->get(['slug', 'updated_at']);
+        $skillCategories = array_keys(config('skills.categories'));
        $pages = Page::published()->get(['slug', 'updated_at']);

        $xml = view('sitemap', [
@@ -26,6 +32,10 @@ class SitemapController extends Controller
            'tags' => $tags,
            'tools' => $tools,
            'toolCategories' => $toolCategories,
+            'mcpServers' => $mcpServers,
+            'mcpServerCategories' => $mcpServerCategories,
+            'skills' => $skills,
+            'skillCategories' => $skillCategories,
            'pages' => $pages,
        ])->render();

@@ -0,0 +1,103 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Skill;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+class SkillController extends Controller
+{
+    public function index(Request $request): View
+    {
+        $category = $request->string('category')->toString();
+        $search = $request->string('q')->toString();
+
+        $skills = Skill::approved()
+            ->when($category, fn ($query) => $query->where('category', $category))
+            ->when($search, fn ($query) => $query->where('name', 'like', "%{$search}%"))
+            ->orderByDesc('featured')
+            ->orderByDesc('views')
+            ->paginate(12)
+            ->withQueryString();
+
+        return view('skills.index', [
+            'skills' => $skills,
+            'categories' => config('skills.categories'),
+            'activeCategory' => $category,
+            'search' => $search,
+            'title' => 'Claude Skills Directory — '.config('app.name'),
+            'description' => 'Discover Claude Skills, with docs, install instructions, and example prompts.',
+            'canonical' => route('skills.index'),
+        ]);
+    }
+
+    public function category(string $category): View
+    {
+        abort_unless(array_key_exists($category, config('skills.categories')), 404);
+
+        $skills = Skill::approved()
+            ->where('category', $category)
+            ->orderByDesc('featured')
+            ->orderByDesc('views')
+            ->paginate(12);
+
+        $label = config("skills.categories.{$category}");
+
+        return view('skills.category', [
+            'skills' => $skills,
+            'categories' => config('skills.categories'),
+            'category' => $category,
+            'label' => $label,
+            'title' => $label.' Claude Skills — '.config('app.name'),
+            'description' => "Claude Skills for {$label}.",
+            'canonical' => route('skills.category', $category),
+        ]);
+    }
+
+    public function show(Skill $skill): View
+    {
+        abort_unless($skill->approved, 404);
+
+        $skill->increment('views');
+
+        $related = Skill::approved()
+            ->where('category', $skill->category)
+            ->whereKeyNot($skill->id)
+            ->limit(4)
+            ->get();
+
+        return view('skills.show', [
+            'skill' => $skill,
+            'related' => $related,
+            'title' => $skill->name.' — Claude Skills — '.config('app.name'),
+            'description' => $this->metaDescription($skill->description),
+            'canonical' => route('skills.show', $skill),
+            'image' => $skill->logo_url,
+        ]);
+    }
+
+    public function visit(Skill $skill): RedirectResponse
+    {
+        abort_unless($skill->approved, 404);
+
+        $skill->increment('clicks');
+
+        return redirect()->away($skill->url);
+    }
+
+    /**
+     * Truncate to ~155 chars without cutting a word in half. Google appends
+     * its own ellipsis when it truncates in search results, so we don't add one.
+     */
+    private function metaDescription(string $description, int $limit = 155): string
+    {
+        if (Str::length($description) <= $limit) {
+            return $description;
+        }
+
+        return Str::of($description)->limit($limit, '')->beforeLast(' ')->toString();
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StoreMcpServerRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:255'],
+            'slug' => ['nullable', 'string', 'max:255', Rule::unique('mcp_servers', 'slug')],
+            'description' => ['required', 'string'],
+            'url' => ['required', 'url', 'max:255'],
+            'docs_url' => ['nullable', 'url', 'max:255'],
+            'logo_url' => ['nullable', 'url', 'max:255'],
+            'category' => ['required', Rule::in(array_keys(config('mcp_servers.categories')))],
+            'install_command' => ['nullable', 'string'],
+            'config_example' => ['nullable', 'string'],
+            'transport' => ['nullable', Rule::in(array_keys(config('mcp_servers.transports')))],
+            'language' => ['nullable', 'string', 'max:100'],
+            'capabilities' => ['sometimes', 'array'],
+            'capabilities.*' => ['string', 'max:255'],
+            'tags' => ['sometimes', 'array'],
+            'tags.*' => ['string', 'max:50'],
+            'featured' => ['sometimes', 'boolean'],
+            'approved' => ['sometimes', 'boolean'],
+        ];
+    }
+}
@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StoreSkillRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:255'],
+            'slug' => ['nullable', 'string', 'max:255', Rule::unique('skills', 'slug')],
+            'description' => ['required', 'string'],
+            'url' => ['required', 'url', 'max:255'],
+            'docs_url' => ['nullable', 'url', 'max:255'],
+            'logo_url' => ['nullable', 'url', 'max:255'],
+            'category' => ['required', Rule::in(array_keys(config('skills.categories')))],
+            'install_instructions' => ['nullable', 'string'],
+            'example_prompt' => ['nullable', 'string'],
+            'requirements' => ['nullable', 'string', 'max:255'],
+            'tags' => ['sometimes', 'array'],
+            'tags.*' => ['string', 'max:50'],
+            'featured' => ['sometimes', 'boolean'],
+            'approved' => ['sometimes', 'boolean'],
+        ];
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdateMcpServerRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => ['sometimes', 'required', 'string', 'max:255'],
+            'slug' => ['sometimes', 'required', 'string', 'max:255', Rule::unique('mcp_servers', 'slug')->ignore($this->route('mcp_server'))],
+            'description' => ['sometimes', 'required', 'string'],
+            'url' => ['sometimes', 'required', 'url', 'max:255'],
+            'docs_url' => ['nullable', 'url', 'max:255'],
+            'logo_url' => ['nullable', 'url', 'max:255'],
+            'category' => ['sometimes', 'required', Rule::in(array_keys(config('mcp_servers.categories')))],
+            'install_command' => ['nullable', 'string'],
+            'config_example' => ['nullable', 'string'],
+            'transport' => ['nullable', Rule::in(array_keys(config('mcp_servers.transports')))],
+            'language' => ['nullable', 'string', 'max:100'],
+            'capabilities' => ['sometimes', 'array'],
+            'capabilities.*' => ['string', 'max:255'],
+            'tags' => ['sometimes', 'array'],
+            'tags.*' => ['string', 'max:50'],
+            'featured' => ['sometimes', 'boolean'],
+            'approved' => ['sometimes', 'boolean'],
+        ];
+    }
+}
@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdateSkillRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => ['sometimes', 'required', 'string', 'max:255'],
+            'slug' => ['sometimes', 'required', 'string', 'max:255', Rule::unique('skills', 'slug')->ignore($this->route('skill'))],
+            'description' => ['sometimes', 'required', 'string'],
+            'url' => ['sometimes', 'required', 'url', 'max:255'],
+            'docs_url' => ['nullable', 'url', 'max:255'],
+            'logo_url' => ['nullable', 'url', 'max:255'],
+            'category' => ['sometimes', 'required', Rule::in(array_keys(config('skills.categories')))],
+            'install_instructions' => ['nullable', 'string'],
+            'example_prompt' => ['nullable', 'string'],
+            'requirements' => ['nullable', 'string', 'max:255'],
+            'tags' => ['sometimes', 'array'],
+            'tags.*' => ['string', 'max:50'],
+            'featured' => ['sometimes', 'boolean'],
+            'approved' => ['sometimes', 'boolean'],
+        ];
+    }
+}
@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class McpServerResource extends JsonResource
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'slug' => $this->slug,
+            'description' => $this->description,
+            'url' => $this->url,
+            'docs_url' => $this->docs_url,
+            'logo_url' => $this->logo_url,
+            'category' => $this->category,
+            'category_label' => $this->category_label,
+            'install_command' => $this->install_command,
+            'config_example' => $this->config_example,
+            'transport' => $this->transport,
+            'transport_label' => $this->transport_label,
+            'language' => $this->language,
+            'capabilities' => $this->capabilities,
+            'tags' => $this->tags,
+            'views' => $this->views,
+            'clicks' => $this->clicks,
+            'featured' => $this->featured,
+            'approved' => $this->approved,
+            'submitted_by' => new UserResource($this->whenLoaded('user')),
+            'created_at' => $this->created_at,
+            'updated_at' => $this->updated_at,
+        ];
+    }
+}
@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class SkillResource extends JsonResource
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'slug' => $this->slug,
+            'description' => $this->description,
+            'url' => $this->url,
+            'docs_url' => $this->docs_url,
+            'logo_url' => $this->logo_url,
+            'category' => $this->category,
+            'category_label' => $this->category_label,
+            'install_instructions' => $this->install_instructions,
+            'example_prompt' => $this->example_prompt,
+            'requirements' => $this->requirements,
+            'tags' => $this->tags,
+            'views' => $this->views,
+            'clicks' => $this->clicks,
+            'featured' => $this->featured,
+            'approved' => $this->approved,
+            'submitted_by' => new UserResource($this->whenLoaded('user')),
+            'created_at' => $this->created_at,
+            'updated_at' => $this->updated_at,
+        ];
+    }
+}