# 라라벨 MCP

모델 컨텍스트 프로토콜(MCP) 서버를 신속하게 구축하기 위한 공식 라라벨 패키지로, 도구, 리소스 및 프롬프트를 통해 AI 클라이언트와 라라벨 애플리케이션 간의 원활한 상호작용을 가능하게 합니다.

Canonical URL: https://a2a-mcp.org/entry/laravel-mcp-ko

Language: ko

Category: MCP Servers

Updated: 2026-03-24

## 개요

Laravel MCP는 Laravel 팀이 개발한 공식 패키지로, 개발자가 Laravel 애플리케이션 내에서 직접 **Model Context Protocol (MCP)** 서버를 구축할 수 있도록 합니다. 2025년에 Laravel의 AI 도구 모음의 일부로 출시되었으며, 모든 MCP 호환 AI 클라이언트(Claude, ChatGPT, Cursor, GitHub Copilot 등)가 보안성과 효율성을 갖추고 Laravel 앱과 상호작용할 수 있도록 서버, 도구, 리소스 및 프롬프트를 정의하는 유창하고 Laravel 네이티브 인터페이스를 제공합니다.

Laravel MCP를 통합하면 애플리케이션이 커스텀 API 없이도 AI 에이전트에게 구조화된 기능을 노출할 수 있는 능력을 얻게 됩니다. 이는 원래 Anthropic이 도입했고 현재 Linux Foundation에서 관리하는 오픈 MCP 표준을 따릅니다.

## 주요 기능

- **표현력 있는 서버 정의**: 속성과 유창한 API를 사용하여 서버 메타데이터(이름, 버전, 지침)를 구성합니다.
- **도구, 리소스 및 프롬프트**: 실행 가능한 도구, 읽을 수 있는 리소스 및 재사용 가능한 프롬프트 템플릿을 위한 커스텀 클래스를 등록합니다.
- **Artisan 스캐폴딩**: `php artisan make:mcp-server`로 완전한 MCP 서버 스켈레톤을 생성합니다.
- **Laravel 네이티브 통합**: Eloquent, 캐싱, 큐, Sanctum 인증 및 서비스 컨테이너를 활용합니다.
- **스트리밍 가능한 HTTP 및 SSE 지원**: 실시간 및 확장 가능한 상호작용을 위한 현대적인 MCP 전송 방식을 기반으로 구축되었습니다.
- **보안 및 인증**: 토큰 기반 인증을 위해 Laravel Sanctum 또는 Passport와 쉽게 통합됩니다.
- **테스트 지원**: 도구 및 서버 동작 테스트를 위해 Pest/PHPUnit과 원활하게 작동합니다.

## 설치 및 빠른 시작

Composer를 통해 설치합니다:

```bash
composer require laravel/mcp
```

라우트 및 구성을 게시합니다(선택 사항):

```bash
php artisan vendor:publish --tag=mcp-config
php artisan vendor:publish --tag=mcp-routes
```

첫 번째 서버를 생성합니다:

```bash
php artisan make:mcp-server WeatherServer
```

서버 클래스 예시:

```php
<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Attributes\Version;
use Laravel\Mcp\Server\Attributes\Instructions;

#[Name('Weather Server')]
#[Version('1.0.0')]
#[Instructions('Provides current weather and forecasts for locations worldwide.')]
class WeatherServer extends Server
{
    protected array $tools = [
        \App\Mcp\Tools\GetCurrentWeather::class,
    ];

    protected array $resources = [
        \App\Mcp\Resources\WeatherGuidelines::class,
    ];
}
```

## 사용 사례

- **AI 기반 개발 도구**: Claude Code나 Cursor 같은 코딩 에이전트에 라라벨 특정 컨텍스트(라우트, 모델, 마이그레이션)를 노출합니다.
- **비즈니스 애플리케이션 통합**: AI 어시스턴트가 CRM 데이터를 조회하거나, 작업을 관리하거나, 전자상거래 기능과 상호작용할 수 있도록 허용합니다.
- **로컬 및 원격 서버**: 개발을 위해 MCP 서버를 로컬에서 실행하거나, 제작용 AI 통합을 위해 원격으로 배포합니다.
- **다중 클라이언트 호환성**: 하나의 서버가 MCP를 지원하는 모든 주요 AI 플랫폼(Anthropic, OpenAI, Google, Microsoft)에서 동작합니다.

커뮤니티 벤치마크에 따르면, 라라벨 MCP는 커스텀 엔드포인트에 비해 AI 기능 통합 시간을 5~8배 단축시키며, 오픈 프로토콜 덕분에 벤더 종속성이 전혀 없습니다.

## 고급 팁과 자주 실수하는 부분

- 제작용 서버에서는 도구 실행을 안전하게 하기 위해 Sanctum 미들웨어를 사용하세요.
- 남용을 방지하기 위해 도구 호출에 속도 제한을 구현하세요.
- 동적 데이터 노출(예: Eloquent 쿼리 결과)을 위해 리소스 템플릿을 활용하세요.
-(자주 실수하는 부분)****: 라우트 등록을 잊어버리는 경우 — 변경 후 항상 `php artisan route:cache`를 실행하세요.
-(고급 팁)****: 향상된 로컬 개발 경험을 위해 라라벨 Boost(또 다른 일등 MCP 서버)와 결합하세요.

## 결론 및 리소스

라라벨 MCP는 신흥 AI 에이전트 생태계에 대한 라라벨의 공식적인 헌신을 나타냅니다. 2026년에 MCP 채택이 증가함에 따라, 라라벨 앱에 MCP 서버를 갖추면 AI 네이티브 인프라로서의 위치를 확보할 수 있습니다.

지금 바로 구축을 시작하세요:
- 공식 문서: https://laravel.com/docs/12.x/mcp
- GitHub: https://github.com/laravel/mcp
- 데모 앱 Locket 탐색: https://github.com/laravel/locket

패키지에 기여하거나 첫 MCP 서버를 구축하세요 — AI 지원 라라벨 개발의 미래가 여기에 있습니다.

## Tags

- 라라벨
- MCP
- AI
- PHP
- 서버
- 모델-컨텍스트-프로토콜
- 도구
- 리소스
- 프롬프트

## Sources

- [Project website](https://github.com/laravel/mcp)