Laravel MCP SDK 实现

Laravel MCP SDK 实现

基于 Laravel 的模型上下文协议 (MCP) 实现,用于标准化 AI 模型与 Laravel 应用的通信。

快速入门

安装

通过 Composer 安装:

composer require laravelmcp/mcp

配置

发布配置文件并设置环境变量:

php artisan vendor:publish --provider="LaravelMCP\MCP\MCPServiceProvider" --tag="config"

.env 文件中添加:

MCP_SERVER_HOST=127.0.0.1 MCP_SERVER_PORT=8080 MCP_SERVER_TRANSPORT=http

启动服务器

使用以下命令启动默认 HTTP 服务:

php artisan mcp:serve

支持多种传输方式(如 WebSocket 和 Stdio):

php artisan mcp:serve --transport=websocket --host=0.0.0.0 --port=8081

注册工具

通过代码注册工具和资源:

$mcp->tool('calculate', [ 'num1' => ['type' => 'number', 'required' => true], 'num2' => ['type' => 'number', 'required' => true], 'operation' => ['type' => 'string', 'required' => true] ])(function ($args) { $num1 = $args['num1']; $num2 = $args['num2']; $operation = $args['operation']; return match ($operation) { '+' => ['result' => $num1 + $num2], '-' => ['result' => $num1 - $num2], '*' => ['result' => $num1 * $num2], '/' => $num2 != 0 ? ['result' => $num1 / $num2] : ['error' => 'Division by zero'], default => ['error' => 'Invalid operation'] }; });

详情请参考完整文档。