# Laravel MCP

官方 Laravel 包，用于快速构建模型上下文协议 (MCP) 服务器，通过工具、资源和提示，实现 AI 客户端与 Laravel 应用程序的无缝交互。

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

Language: zh

Category: MCP Servers

Updated: 2026-03-24

## 概述

Laravel MCP 是 Laravel 团队开发的官方包，使开发者能够直接在 Laravel 应用程序中构建**模型上下文协议（Model Context Protocol，MCP）**服务器。作为 Laravel AI 工具套件的一部分于 2025 年推出，它提供了一个流畅、原生的 Laravel 接口，用于定义服务器、工具、资源和提示，使得任何兼容 MCP 的 AI 客户端（Claude、ChatGPT、Cursor、GitHub Copilot 等）能够安全高效地与您的 Laravel 应用交互。

通过集成 Laravel MCP，应用程序能够向 AI 智能体暴露结构化能力，无需自定义 API，遵循最初由 Anthropic 引入、现由 Linux 基金会管理的开放 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 等编码代理暴露 Laravel 特定上下文（路由、模型、迁移）。
- **业务应用集成**：允许 AI 助手查询 CRM 数据、管理任务或与电子商务功能交互。
- **本地与远程服务器**：在本地运行 MCP 服务器进行开发，或部署到远程环境用于生产环境 AI 集成。
- **多客户端兼容性**：一个服务器可兼容所有支持 MCP 的主要 AI 平台（Anthropic、OpenAI、Google、Microsoft）。

社区基准测试表明，相比于自定义端点，Laravel MCP 可将 AI 功能的集成时间减少 5–8 倍，且得益于开放协议，完全避免了供应商锁定。

## 高级技巧与常见陷阱

- 在生产服务器中使用 Sanctum 中间件以确保工具执行的安全性。
- 在工具调用上实现速率限制，防止滥用。
- 利用资源模板进行动态数据暴露（例如，Eloquent 查询结果）。
- **陷阱**：忘记注册路由——每次变更后务必运行 `php artisan route:cache`。
- **高级技巧**：与 Laravel Boost（另一个官方 MCP 服务器）结合使用，以提升本地开发体验。

## 结论与资源

Laravel MCP 代表了 Laravel 对新兴 AI 代理生态系统的官方承诺。随着 MCP 在 2026 年的采用率不断增长，在 Laravel 应用中部署 MCP 服务器将使其成为 AI 原生基础设施。

立即开始构建：
- 官方文档：https://laravel.com/docs/12.x/mcp
- GitHub：https://github.com/laravel/mcp
- 探索演示应用 Locket：https://github.com/laravel/locket

为该软件包贡献代码或构建您的首个 MCP 服务器——AI 辅助的 Laravel 开发未来已来。

## Tags

- laravel
- mcp
- ai
- php
- 服务器
- 模型上下文协议
- 工具
- 资源
- 提示

## Sources

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