opgginc/laravel-mcp-server

OPによるLaravel MCPサーバー。GG

LaravelとLumenでルートファーストのMCPサーバーを構築する

公式ウェブサイト

英語 | ポルトガエス・ド・ブラジル | 한국어 | Русский | 简体中文 | 繁體中文 | Polski | スペイン語

ブレイキングチェンジズ 2.0.0

• エンドポイントの設定が設定駆動の登録からルート駆動の登録へ移行しました。
• ストリーミング可能なHTTPは唯一サポートされているトランスポートです。
• サーバーメタデータのミューテーターはsetServerInfo(...)に統合されます。
• レガシーツールの輸送方式が実行時から削除されました(messageType()、ProcessMessageType::SSE)。

完全な移行ガイド:docs/migrations/v2.0.0-migration.md

概要

Laravel MCP Serverは、LaravelおよびLumen向けにルートベースのMCPエンドポイント登録を提供します。

主なポイント:

• ストリーミング可能なHTTPトランスポート
• ルート優先構成(Route::mcp(...) / McpRoute::register(...))
• ツール、リソース、リソーステンプレート、エンドポイントごとのプロンプト登録
• ルートキャッシュ対応エンドポイントメタデータ

要件

• PHP >= 8.2
• ララベル(イルミネート)>= 9.x
• ルーメン >= 9.x(任意)

クイックスタート

1) インストール

2) エンドポイントをレジスタジアス(Laravel)

2025-11-25をサポートしないクライアントとの互換性が必要な場合は、以下を設定します。

Laravel MCP Server by OP.GG

Build a route-first MCP server in Laravel and Lumen

Official Website

English | Português do Brasil | 한국어 | Русский | 简体中文 | 繁體中文 | Polski | Español

Breaking Changes 2.0.0

• Endpoint setup moved from config-driven registration to route-driven registration.
• Streamable HTTP is the only supported transport.
• Server metadata mutators are consolidated into setServerInfo(...).
• Legacy tool transport methods were removed from runtime (messageType(), ProcessMessageType::SSE).

Full migration guide: docs/migrations/v2.0.0-migration.md

Overview

Laravel MCP Server provides route-based MCP endpoint registration for Laravel and Lumen.

Key points:

• Streamable HTTP transport
• Route-first configuration (Route::mcp(...) / McpRoute::register(...))
• Tool, resource, resource template, and prompt registration per endpoint
• Route cache compatible endpoint metadata

Requirements

• PHP >= 8.2
• Laravel (Illuminate) >= 9.x
• Lumen >= 9.x (optional)

Quick Start

1) Install

composer require opgginc/laravel-mcp-server

2) Register an endpoint (Laravel)

use Illuminate\Support\Facades\Route;
use OPGG\LaravelMcpServer\Enums\ProtocolVersion;
use OPGG\LaravelMcpServer\Services\ToolService\Examples\HelloWorldTool;
use OPGG\LaravelMcpServer\Services\ToolService\Examples\VersionCheckTool;

Route::mcp('/mcp')
    ->setServerInfo(
        name: 'OP.GG MCP Server',
        version: '2.0.0',
    )
    ->setConfig(
        compactEnumExampleCount: 3,
    )
    ->setProtocolVersion(ProtocolVersion::V2025_11_25)
    ->enabledApi()
    ->tools([
        HelloWorldTool::class,
        VersionCheckTool::class,
    ]);