简介

Laravel MCP 使您能够快速为 Laravel 应用程序搭建 MCP 服务器。MCP 服务器允许 AI 客户端通过 模型上下文协议 与您的 Laravel 应用程序进行交互。

官方文档

Laravel MCP 的官方文档可在此处找到：Laravel 官网。

贡献

感谢您考虑为 Laravel MCP 贡献！贡献指南可在 Laravel 文档 中找到。

行为准则

为确保 Laravel 社区对所有人开放且友好，请仔细阅读并遵守 行为准则。

安全漏洞

请查阅 我们的安全政策，了解如何报告安全漏洞。

许可证

Laravel MCP 是一款开源软件，采用 MIT 许可证 进行授权。

Laravel MCP 快速上手指南

Laravel MCP 允许你为 Laravel 应用快速构建 MCP（Model Context Protocol）服务器，使 AI 客户端能够通过标准协议与你的应用进行交互。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• PHP: >= 8.2
• Laravel: >= 11.0
• Composer: 最新稳定版
• 系统: Linux, macOS, 或 Windows (WSL)

提示：国内开发者建议使用 Composer 中国全量镜像以加速依赖安装。 设置方法：composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

安装步骤

通过 Composer 将 Laravel MCP 安装到你的项目中：

composer require laravel/mcp

安装完成后，Laravel 会自动注册相关服务提供者。你可以立即开始配置和使用。

基本使用

1. 创建 MCP 服务器类

使用 Artisan 命令生成一个新的 MCP 服务器类：

php artisan make:mcp-server MyServer

这将生成一个位于 app/Mcp/Servers/MyServer.php 的文件。

2. 定义工具（Tools）

打开生成的服务器类，定义一个供 AI 调用的简单工具。例如，创建一个获取当前时间的工具：

<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Types\Tool;

class MyServer extends Server
{
    public function tools(): array
    {
        return [
            Tool::make('get_current_time')
                ->description('Get the current date and time.')
                ->handler(function () {
                    return now()->toDateTimeString();
                }),
        ];
    }
}

3. 注册服务器

在 bootstrap/app.php 中注册你的 MCP 服务器（Laravel 11+ 风格）：

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

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting()
    ->then(function (Application $app) {
        Mcp::server(MyServer::class);
        
        // 其他配置...
    });

4. 运行与测试

启动你的 Laravel 开发服务器：

php artisan serve

MCP 端点通常暴露在 /mcp 路径下。你可以使用支持 MCP 协议的 AI 客户端（如 Cursor、Zed 或专门的 MCP Inspector 工具）连接到 http://localhost:8000/mcp，即可调用你定义的 get_current_time 工具。