Laravel MCP Server——让 PHP 开发者也能玩转 AI Agent 协议

背景：MCP 协议浪潮下的 PHP 空白

2024 年底，Anthropic 推出 Model Context Protocol（MCP）协议，迅速成为 AI 工具生态的通用接口标准。GitHub 上围绕 MCP 的开源项目呈爆发式增长——从 Claude Desktop 的 MCP Server 插件，到各种 AI 工具的协议适配层，MCP 正在重塑 AI Agent 的连接方式。

然而，有一个重要的事实被忽视：全球最大的 Web 框架社区之一——Laravel（PHP）——长期缺乏一个官方、标准的 MCP Server 实现方案。全球数百万 Laravel 开发者如果想接入 MCP 生态，只能手写 PHP 代码解析协议，门槛极高。

2025 年，OP.GG（韩国知名游戏数据平台）工程团队开源了 laravel-mcp-server，正是为了填补这一空白。OP.GG 团队每天处理海量用户请求，长期探索 AI 与现有 PHP 技术栈的融合，这套方案源自真实生产环境的验证。

核心功能：路由优先的 MCP 服务器

Laravel MCP Server 的设计理念是"路由优先"（Route-first），这与 Laravel 开发者最熟悉的开发模式完全一致。

传统的 Laravel 路由注册只需要一行代码即可暴露一个 MCP 端点：

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

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,
    ]);

这行代码背后做了什么？路由注册会自动生成符合 MCP 规范的端点元数据，包括工具列表、资源定义、Prompt 模板等。同时支持流式 HTTP 传输（Streamable HTTP），这是 2025 年 MCP 协议的最新传输标准，替代了早期基于 Server-Sent Events（SSE）的方案。

项目 2.0.0 版本进行了一次重大重构，彻底移除了旧的 SSE 传输方式，统一为 Streamable HTTP。这一变更反映了 MCP 协议栈在传输层的演进方向。

技术架构：模块化插件体系

从源码结构来看，Laravel MCP Server 遵循 Laravel Package 的标准开发规范，核心目录包括：

• Services/ToolService：工具注册与执行层，开发者通过实现 Tool 接口自定义 AI 可调用的工具。每个 Tool 包含名称、描述、输入模式和处理器逻辑。
• Protocol：MCP 协议核心实现，处理 JSON-RPC 请求解析与响应序列化。
• Transports：传输层抽象，当前支持 Streamable HTTP，为未来多传输方式预留扩展空间。
• Routing：路由注册与端点元数据生成层，深度集成 Laravel 路由系统。
• Http：中间件与请求处理管道。
• Enums：协议版本枚举、消息类型等常量定义。

项目依赖非常克制：spatie/laravel-package-tools 用于包注册基础设施，核心仅依赖 illuminate/contracts。这意味着它能同时支持 Laravel 9.x ~ 13.x，以及 Lumen 框架，兼容范围极广。

开发质量方面，项目集成了 Pest（测试框架）、PHPStan（静态分析）、Laravel Pint（代码格式化），CI 流程在 GitHub Actions 上完整覆盖。

适用场景与上手体验

最适合的场景：

• 在已有 Laravel/Lumen 后端项目中快速暴露 AI Agent 接口
• 将 Laravel 的业务能力（数据库查询、文件处理、定时任务等）封装为 AI 可调用的工具
• 企业内部 AI 平台建设中，为 PHP 团队提供标准化的 Agent 接口开发方案

上手门槛： 对 Laravel 有基本了解的开发者，约 30 分钟即可完成从安装到第一个自定义 Tool 的全流程。官方提供了完整的多语言文档（含简体中文 README）。

当前局限：

• 无 Web UI，纯后台 API 库，非面向终端用户的应用
• 无 Docker 支持，需要自己编写容器化部署配置
• 社区规模较小（332★，0 forks），文档深度和社区生态仍在建设中

行业意义

MCP 协议的本质是让 AI Agent 能够"插拔式"调用各种外部工具。在这一生态中，Python 生态已有大量成熟实现，而 Laravel MCP Server 的出现意味着 PHP 生态终于有了一条官方、标准、可维护的接入路径。

对于 OP.GG 这样的公司而言，将内部沉淀的 AI 能力以 MCP Server 形式开源，既是技术品牌建设，也是生态共建的战略布局。随着 Laravel 在亚洲市场（尤其是东南亚）的高速增长，这个项目有望成为 PHP 开发者进入 AI Agent 领域的入门级首选工具。