สร้าง MCP Server ของคุณเองด้วย Laravel

# วิธีที่ 1: ใช้ Laravel Installer
laravel new my-mcp-server

# วิธีที่ 2: ใช้ Composer โดยตรง
composer create-project laravel/laravel my-mcp-server

# เข้าไปในโฟลเดอร์แล้วรัน server
cd my-mcp-server
php artisan serve

php artisan make:controller McpController
php artisan make:service McpToolService  # สร้างเอง หรือวาง class ใน app/Services/

use App\Http\Controllers\McpController;
use Illuminate\Support\Facades\Route;

// MCP Server endpoint — รับ JSON-RPC ทุก method ที่นี่
Route::post('/mcp', [McpController::class, 'handle']);

// SSE endpoint สำหรับ streaming (optional)
Route::get('/mcp/sse', [McpController::class, 'sse']);

<?php

namespace App\Http\Controllers;

use App\Services\McpToolService;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;

class McpController extends Controller
{
    public function __construct(
        private McpToolService $toolService
    ) {}

    public function handle(Request $request): JsonResponse
    {
        $method  = $request->input('method');
        $params  = $request->input('params', []);
        $id      = $request->input('id');

        $result = match ($method) {
            'initialize'  => $this->initialize(),
            'tools/list'  => $this->$this->listTools(),
            'tools/call'  => $this->callTool($params),
            default       => ['error' => 'Method not found'],
        };

        return response()->json([
            'jsonrpc' => '2.0',
            'id'      => $id,
            'result'  => $result,
        ]);
    }

    private function initialize(): array
    {
        return [
            'protocolVersion' => '2024-11-05',
            'serverInfo'      => [
                'name'    => 'my-laravel-mcp',
                'version' => '1.0.0',
            ],
            'capabilities'    => ['tools' => (object) []],
        ];
    }

    private function listTools(): array
    {
        return ['tools' => $this->toolService->getToolSchemas()];
    }

    private function callTool(array $params): array
    {
        $name = $params['name'] ?? '';
        $args = $params['arguments'] ?? [];

        $output = $this->toolService->execute($name, $args);

        return [
            'content' => [['type' => 'text', 'text' => $output]],
        ];
    }
}

<?php

namespace App\Services;

use App\Models\Product;

class McpToolService
{
    /**
     * ประกาศ schema ของ tools ทั้งหมดที่ server นี้มี
     * AI จะนำไปเข้าใจว่าแต่ละ tool รับ argument อะไร
     */
    public function getToolSchemas(): array
    {
        return [
            [
                'name'        => 'search_products',
                'description' => 'ค้นหาสินค้าจากชื่อหรือหมวดหมู่',
                'inputSchema' => [
                    'type'       => 'object',
                    'properties' => [
                        'keyword' => [
                            'type'        => 'string',
                            'description' => 'คำค้นหา',
                        ],
                        'limit' => [
                            'type'        => 'integer',
                            'description' => 'จำนวนผลลัพธ์สูงสุด',
                            'default'     => 10,
                        ],
                    ],
                    'required' => ['keyword'],
                ],
            ],
            [
                'name'        => 'get_order_status',
                'description' => 'ตรวจสถานะ order จาก order ID',
                'inputSchema' => [
                    'type'       => 'object',
                    'properties' => [
                        'order_id' => [
                            'type' => 'integer',
                        ],
                    ],
                    'required' => ['order_id'],
                ],
            ],
        ];
    }

    /**
     * Execute tool ตาม name ที่ AI ส่งมา
     */
    public function execute(string $name, array $args): string
    {
        return match ($name) {
            'search_products'  => $this->searchProducts($args),
            'get_order_status' => $this->getOrderStatus($args),
            default            => 'ไม่พบ tool ที่ระบุ',
        };
    }

    private function searchProducts(array $args): string
    {
        $keyword = $args['keyword'];
        $limit   = $args['limit'] ?? 10;

        // ใช้ Eloquent ค้นหาสินค้า
        $products = Product::where('name', 'like', "%{$keyword}%")
            ->orWhere('category', 'like', "%{$keyword}%")
            ->limit($limit)
            ->get(['id', 'name', 'price', 'category']);

        if ($products->isEmpty()) {
            return "ไม่พบสินค้าที่ตรงกับ: {$keyword}";
        }

        // ส่งกลับเป็น JSON string ให้ AI อ่านได้
        return json_encode($products->toArray(), JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
    }

    private function getOrderStatus(array $args): string
    {
        $orderId = (int) ($args['order_id'] ?? 0);
        // ... query จาก orders table ...
        return "Order #{$orderId}: กำลังจัดส่ง";
    }
}

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class McpAuthMiddleware
{
    public function handle(Request $request, Closure $next)
    {
        $token = $request->bearerToken();

        if ($token !== config('mcp.secret_token')) {
            return response()->json([
                'jsonrpc' => '2.0',
                'error'   => [
                    'code'    => -32001,
                    'message' => 'Unauthorized',
                ],
            ], 401);
        }

        return $next($request);
    }
}

// ใน routes/api.php — ครอบ middleware
Route::middleware('mcp.auth')->post('/mcp', [McpController::class, 'handle']);

curl -X POST http://localhost:8000/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-secret-token" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -X POST http://localhost:8000/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-secret-token" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_products",
      "arguments": { "keyword": "กาแฟ", "limit": 5 }
    }
  }'