Практика: MCP-сервер для заказов

php artisan make:mcp-server OrderServer

namespace App\Mcp\Servers;

use App\Mcp\Tools\LookupOrder;
use App\Mcp\Tools\CreateOrder;
use App\Mcp\Resources\OrderResource;
use App\Mcp\Prompts\SummarizeOrders;
use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Instructions;

#[Instructions('Управление заказами. Используй tools для поиска и создания.')]
class OrderServer extends Server
{
    protected array $tools = [
        LookupOrder::class,
        CreateOrder::class,
    ];

    protected array $resources = [
        OrderResource::class,
    ];

    protected array $prompts = [
        SummarizeOrders::class,
    ];
}

php artisan make:mcp-tool LookupOrder

class LookupOrder extends Tool
{
    protected string $description = 'Находит заказ по ID.';

    public function schema(JsonSchema $schema): array
    {
        return ['order_id' => $schema->integer()->required()];
    }

    public function handle(Request $request): Response
    {
        $order = Order::find($request->get('order_id'));

        return $order
            ? Response::text("Заказ #{$order->id}: {$order->status}")
            : Response::error('Заказ не найден');
    }
}

class OrderResource extends Resource
{
    protected string $uri = 'orders://{id}';

    public function handle(Request $request): Response
    {
        return Response::json(Order::find($request->get('id'))->toArray());
    }
}

class SummarizeOrders extends Prompt
{
    protected string $description = 'Суммирует заказы пользователя.';

    public function handle(Request $request): Response
    {
        return Response::text('Проанализируй заказы пользователя и выдели основные тренды.');
    }
}

// routes/ai.php
Mcp::oauthRoutes();
Mcp::web('/mcp/orders', OrderServer::class)->middleware('auth:api');

npx @modelcontextprotocol/inspector http://localhost/mcp/orders