Laravel MCP (管理控制面板) 完整搭建指南

Laravel MCP (管理控制面板) 完整搭建指南

一、环境准备与项目初始化

1. 系统要求确认

• PHP 8.1+ (推荐8.2)
• Composer 2.5+
• MySQL 8.0+/MariaDB 10.6+
• Node.js 18+ (LTS版本)

2. 项目创建与基础配置

# 创建项目（使用Laravel最新稳定版）
composer create-project laravel/laravel mcp-system --prefer-dist

# 进入项目目录
cd mcp-system

# 初始化git仓库
git init
echo ".env" >> .gitignore
echo "/storage/*" >> .gitignore
echo "/public/hot" >> .gitignore

二、核心功能模块安装

1. 安装必备扩展包

# 权限管理
composer require spatie/laravel-permission

# API认证
composer require laravel/sanctum

# 后台UI工具包
composer require infinety-es/adminlte-laravel-installer

# 数据表格工具
composer require yajra/laravel-datatables-oracle

2. 初始化AdminLTE后台模板

php artisan adminlte:install --force
php artisan adminlte:plugins install
php artisan adminlte:menu

三、数据库与认证系统配置

1. 数据库设置

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mcp_production
DB_USERNAME=mcp_admin
DB_PASSWORD=YourSecurePassword123!

2. 运行迁移与安装

# 数据库迁移
php artisan migrate:fresh --seed

# 发布扩展包资源
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan vendor:publish --provider="Yajra\DataTables\DataTablesServiceProvider"

四、MCP核心架构搭建

1. 创建项目目录结构

app/
├── Http/
│   ├── Controllers/
│   │   ├── MCP/
│   │   │   ├── Auth/
│   │   │   ├── System/
│   │   │   └── Modules/
│   ├── Middleware/
│   │   └── MCPAuth.php
│   └── Requests/
│       └── MCP/
routes/
├── mcp.php

2. 配置多路由系统

编辑 app/Providers/RouteServiceProvider.php:

public function boot()
{
    $this->configureRateLimiting();
    
    $this->routes(function () {
        Route::prefix('api')
            ->middleware('api')
            ->namespace($this->namespace)
            ->group(base_path('routes/api.php'));

        Route::middleware('web')
            ->namespace($this->namespace)
            ->group(base_path('routes/web.php'));

        // MCP专用路由
        Route::prefix('mcp')
            ->middleware(['web', 'mcp.auth'])
            ->namespace('App\Http\Controllers\MCP')
            ->group(base_path('routes/mcp.php'));
    });
}

五、前端资源构建

1. 安装前端依赖

npm install --save-dev vite laravel-vite-plugin
npm install @popperjs/core bootstrap@5.3.0-alpha1 sass datatables.net-bs5

2. 配置Vite

vite.config.js:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/sass/mcp/app.scss',
                'resources/js/mcp/app.js'
            ],
            refresh: true,
        }),
    ],
});

六、开发工作流

1. 启动开发服务器

# 后端服务
php artisan serve --port=8000

# 前端热重载
npm run dev

# 监控编译
npx mix watch

2. 常用代码生成

# 生成MCP模块
php artisan make:module Users -a

# 生成策略类
php artisan make:policy UserPolicy --model=User

# 生成表单请求
php artisan make:request MCP/UserStoreRequest

七、生产环境部署建议

1. 优化配置

# 缓存优化
php artisan config:cache
php artisan route:cache
php artisan view:cache

# 前端构建
npm run build

# Composer优化
composer install --optimize-autoloader --no-dev

2. 安全建议

APP_ENV=production
APP_DEBUG=false
APP_KEY=base64:yourGeneratedKeyHere=

SESSION_DRIVER=database
SESSION_SECURE_COOKIE=true

八、扩展建议

1. 推荐安装的扩展包

# 日志分析
composer require rap2hpoutre/laravel-log-viewer

# 系统监控
composer require spatie/laravel-activitylog
composer require spatie/laravel-health

# 文件管理
composer require unisharp/laravel-filemanager

这个搭建方案提供了完整的Laravel MCP开发环境，包含了后台管理系统所需的认证、权限、UI组件等核心功能，并采用了现代化的前端构建工具。根据项目实际需求，可以在此基础上继续扩展功能模块。