PHPでMCPサーバーを構築する方法｜公式SDK・Laravel・素のPHPを徹底比較

composer require mcp/sdk

<?php

use PhpMcp\Server\Attributes\McpTool;

class WeatherTools
{
    /**
     * 指定都市の天気情報を取得する
     *
     * @param string $city 都市名（例: Tokyo）
     */
    #[McpTool(name: 'get_weather', description: '指定都市の天気を取得')]
    public function getWeather(string $city): array
    {
        // 天気APIを呼び出す処理
        return [
            'city' => $city,
            'temperature' => 22,
            'condition' => 'sunny',
        ];
    }
}

<?php

use PhpMcp\Server\Attributes\McpResource;

class AppResources
{
    #[McpResource(uri: 'config://app/version', name: 'app_version')]
    public function getVersion(): string
    {
        return '2.1.0';
    }
}

<?php
// server.php

require __DIR__ . '/vendor/autoload.php';

use PhpMcp\Server\Server;
use PhpMcp\Server\Transports\StdioServerTransport;

$server = Server::make()
    ->withTool(new WeatherTools())
    ->withResource(new AppResources())
    ->build();

$transport = new StdioServerTransport();
$server->listen($transport);

{
  "mcpServers": {
    "my-php-server": {
      "command": "php",
      "args": ["/path/to/server.php"]
    }
  }
}

composer require laravel/mcp
php artisan vendor:publish --tag=ai-routes

php artisan make:mcp-tool WeatherTool

<?php

namespace App\Mcp\Tools;

use Laravel\Mcp\Tool;

class WeatherTool extends Tool
{
    public string $name = 'get_weather';
    public string $description = '都市名から天気情報を取得';

    public function parameters(): array
    {
        return [
            'city' => [
                'type' => 'string',
                'description' => '都市名',
                'required' => true,
            ],
        ];
    }

    public function handle(array $arguments): mixed
    {
        $city = $arguments['city'];
        // 天気API呼び出し
        return [
            'city' => $city,
            'temperature' => 22,
            'condition' => 'sunny',
        ];
    }
}

<?php

use Laravel\Mcp\Facades\Mcp;
use App\Mcp\Servers\WeatherServer;

// HTTPベース（リモートクライアント向け）
Mcp::web('/mcp/weather', WeatherServer::class)
    ->middleware(['throttle:mcp']);

// stdio（ローカルクライアント向け）
Mcp::local('weather', WeatherServer::class);

php artisan mcp:start weather

<?php
// mcp_server.php

header('Content-Type: application/json');

$input = json_decode(file_get_contents('php://input'), true);

if (!$input || !isset($input['method'])) {
    http_response_code(400);
    echo json_encode(['error' => 'Invalid request']);
    exit;
}

$method = $input['method'];
$id = $input['id'] ?? null;

match ($method) {
    'initialize' => respond($id, [
        'protocolVersion' => '2025-03-26',
        'capabilities' => ['tools' => ['listChanged' => false]],
        'serverInfo' => ['name' => 'php-minimal', 'version' => '1.0.0'],
    ]),
    'tools/list' => respond($id, [
        'tools' => [
            [
                'name' => 'current_time',
                'description' => '現在の日時を返す',
                'inputSchema' => [
                    'type' => 'object',
                    'properties' => [
                        'timezone' => [
                            'type' => 'string',
                            'description' => 'タイムゾーン（例: Asia/Tokyo）',
                        ],
                    ],
                ],
            ],
        ],
    ]),
    'tools/call' => handleToolCall($id, $input['params'] ?? []),
    'notifications/initialized' => null, // 通知は応答不要
    default => respondError($id, -32601, "Method not found: {$method}"),
};

function handleToolCall(mixed $id, array $params): void
{
    $toolName = $params['name'] ?? '';
    $args = $params['arguments'] ?? [];

    if ($toolName === 'current_time') {
        $tz = $args['timezone'] ?? 'Asia/Tokyo';
        $dt = new DateTimeImmutable('now', new DateTimeZone($tz));
        respond($id, [
            'content' => [
                ['type' => 'text', 'text' => $dt->format('Y-m-d H:i:s T')],
            ],
        ]);
        return;
    }

    respondError($id, -32602, "Unknown tool: {$toolName}");
}

function respond(mixed $id, array $result): void
{
    echo json_encode([
        'jsonrpc' => '2.0',
        'id' => $id,
        'result' => $result,
    ]);
    exit;
}

function respondError(mixed $id, int $code, string $message): void
{
    echo json_encode([
        'jsonrpc' => '2.0',
        'id' => $id,
        'error' => ['code' => $code, 'message' => $message],
    ]);
    exit;
}

php -S localhost:8080 mcp_server.php

{
  "mcpServers": {
    "my-php-tools": {
      "command": "php",
      "args": ["/path/to/server.php"]
    }
  }
}

{
  "mcpServers": {
    "my-php-tools": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

{
  "servers": {
    "my-php-tools": {
      "command": "php",
      "args": ["/path/to/server.php"]
    }
  }
}