opgginc/laravel-mcp-server

원글 작성자 라라벨 MCP 서버. GG

Laravel과 Lumen으로 경로 우선 MCP 서버를 구축하세요

공식 웹사이트

영어 | 포르투게스 두 브라질 | 한국어 | Русский | 简体中文 | 繁體中文 | 폴스키 | 에스파뇰

변화 깨기 2.0.0

• 엔드포인트 설정이 설정 기반 등록에서 경로 기반 등록으로 전환됨.
• 스트리밍 가능한 HTTP만이 지원되는 전송 수단입니다.
• 서버 메타데이터 뮤테이터는 setServerInfo(...)에 통합됩니다.
• 레거시 툴 전송 방식이 런타임에서 제거되었습니다 (messageType(), ProcessMessageType::SSE).

전체 마이그레이션 가이드: docs/migrations/v2.0.0-migration.md

개요

Laravel MCP 서버는 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,
    ]);