Laravel MCP Ecosystem

基于托管管理的Laravel认证系统-MCP服务器架构

一个全面的模型上下文协议（MCP）服务器生态系统，用于构建一个完整的Laravel身份验证系统，包括域/托管订阅管理和基于SSH的文件管理。

环境分析

✅ 您的环境已准备就绪：

• PHP 8.2.12（CLI）和Zend Engine v4.2.12
• PHP依赖管理编辑器2.7.4
• Node.js 20.13.1和npm 10.5.2用于MCP服务器开发
• Windows PowerShell 5.1环境
• 检测到用于本地开发的XAMPP堆栈

MCP服务器架构

基于MCP官方文件和最佳实践https://modelcontextprotocol.io/docs/develop/build-server，以下是Laravel应用程序所需的六个专用MCP服务器：

1.📧 Laravel认证MCP服务器(laravel-auth-mcp-server)

目的：完整的用户身份验证和授权系统

主要特点：

• 使用会话管理进行用户注册、登录、注销
• JWT令牌生成、验证和刷新
• 使用bcrypt进行密码哈希（兼容Laravel）
• 基于角色的访问控制（RBAC）系统
• 用户配置文件管理（CRUD操作）
• Laravel Sanctum/Passport集成
• 安全功能：速率限制、CSRF保护

提供的工具：

• register-user, authenticate-user, logout-user
• generate-jwt-token, validate-jwt-token, refresh-token
• hash-password, verify-password
• assign-user-role, check-user-permission
• create-user-profile, update-user-profile, get-user-profile

2.🗄️ 数据库管理MCP服务器(database-mcp-server)

目的：全面的数据库操作和模式管理

主要特点：

• 支持多数据库（MySQL、PostgreSQL、SQLite）
• Laravel迁移管理（创建、运行、回滚）
• 架构操作（表、列、索引、外键）
• 带安全验证的原始查询执行
• 数据库备份和恢复功能
• 连接池和管理

提供的工具：

• connect-database, test-connection, switch-database
• create-migration, run-migrations, rollback-migration
• create-table, alter-table, drop-table, describe-table
• execute-query, insert-data, update-data, select-data
• backup-database, restore-database, optimize-tables

3.🔐 SSH文件管理器MCP服务器(ssh-filemanager-mcp-server)

目的：通过SSH/SFTP进行安全的远程文件管理，并支持图形界面

主要特点：

• 基于密钥的身份验证的SSH连接管理
• SFTP文件操作（上传、下载、浏览、编辑）
• 远程目录导航和管理
• 文件权限和所有权管理
• 归档操作（创建/提取ZIP/TAR文件）
• 远程服务器上的终端命令执行

提供的工具：

• connect-ssh, disconnect-ssh, test-ssh-connection
• list-files, upload-file, download-file, read-file-content
• create-directory, delete-file, move-file, copy-file
• change-permissions, change-owner, get-file-info
• create-archive, extract-archive, execute-command

4.🌐 域/主机管理MCP服务器(hosting-management-mcp-server)

目的：完整的域名和托管订阅管理系统

主要特点：

• 域名注册、续订和管理
• DNS记录管理（A、CNAME、MX、TXT记录）
• SSL证书监控和管理
• 托管订阅跟踪和计费集成
• 多供应商API集成（Namecheap、GoDaddy、Cloudflare）
• 到期监控和自动续订警报

提供的工具：

• register-domain, check-domain-availability, renew-domain
• create-dns-record, update-dns-record, list-dns-records
• generate-ssl-certificate, install-ssl-certificate, check-ssl-status
• create-hosting-subscription, list-hosting-subscriptions, get-subscription-usage
• setup-domain-monitoring, get-renewal-dates, send-expiration-alerts

5.⚡ Laravel Artisan MCP服务器(laravel-artisan-mcp-server)

目的：完成Laravel CLI和代码生成自动化

主要特点：

• 完整的Artisan命令执行和管理
• 代码生成（控制器、模型、中间件、请求）
• 迁移和播种机管理
• 缓存管理（配置、路由、视图缓存）
• 队列工作人员管理和作业处理
• 测试与PHPUnit的集成

提供的工具：

• make-controller, make-model, make-middleware, make-migration
• run-migrations, rollback-migrations, seed-database
• cache-clear, config-cache, route-cache, view-cache
• queue-work, queue-restart, run-tests, serve-application
• optimize-application, key-generate, storage-link

6.📦 PHP编辑器MCP服务器(php-composer-mcp-server)

目的：高级PHP依赖和包管理

主要特点：

• 软件包安装、更新和删除
• 依赖性解决和冲突检测
• 语义版本控制和约束管理
• 自动加载器优化（PSR-4，类图）
• 安全漏洞扫描
• 自定义存储库管理

提供的工具：

• install-package, update-package, remove-package, search-packages
• show-dependencies, check-outdated, analyze-dependencies
• dump-autoload, optimize-autoloader, configure-autoload
• audit-security, check-platform-requirements, validate-composer
• init-composer-project, configure-repositories

集成体系结构

服务器之间的数据流

Laravel App Dashboard
       ↓
[Auth Server] ← → [Database Server] ← → [Artisan Server]
       ↓                                       ↓
[Hosting Server] ← → [SSH File Manager] ← → [Composer Server]

仪表板功能

1. 身份验证面板：登录/注销、用户管理、角色分配
2. 订阅仪表板：域名和托管服务概述及续订日期
3. 文件管理器界面：具有上传/下载功能的SSH身份验证远程文件浏览器
4. 数据库控制台：查询执行、迁移管理、备份/还原
5. 开发工具：Artisan命令、包管理、代码生成

最佳实践实施

1.官方MCP服务器标准

• 每台服务器都遵循官方的MCP SDK结构
• 使用结构化错误响应进行正确的错误处理
• 基于资源的文档和模式定义
• 使用Zod模式进行输入验证
• 用于类型安全的TypeScript实现

2.安全最佳实践

• 具有安全密钥管理的JWT身份验证
• 基于SSH密钥的文件操作身份验证
• 使用参数化查询防止SQL注入
• 输入净化和验证
• 速率限制和请求限制

3.Laravel集成标准

• 兼容Laravel 10+框架结构
• 使用Laravel命名约定和模式
• 支持Laravel Sanctum进行API身份验证
• 遵循Laravel数据库迁移模式
• 与Laravel的缓存系统集成

4.开发工作流程

• 每个MCP服务器都可以独立部署
• 模块化架构允许选择性使用
• 开发和生产配置
• 全面的日志记录和错误跟踪
• 自动化测试集成

后续步骤

1. 安装：使用安装每个MCP服务器的依赖项 npm install
2. 配置：设置数据库、SSH和API凭据的环境变量
3. 构建：使用编译TypeScript npm run build 对于每台服务器
4. 整合：配置Claude Desktop以使用所有MCP服务器
5. 测试：独立验证每个服务器的功能
6. 仪表板开发：构建利用所有MCP服务器的Laravel前端

该架构为您的Laravel身份验证系统提供了一个完整的、生产就绪的基础，具有全面的托管管理功能，所有这些都遵循MCP最佳实践和官方文档标准。

Claude桌面配置

{
  "mcpServers": {
    "laravel-auth": {
      "command": "node",
      "args": ["./laravel-auth-mcp-server/dist/index.js"]
    },
    "database": {
      "command": "node", 
      "args": ["./database-mcp-server/dist/index.js"]
    },
    "ssh-filemanager": {
      "command": "node",
      "args": ["./ssh-filemanager-mcp-server/dist/index.js"]
    },
    "hosting-management": {
      "command": "node",
      "args": ["./hosting-management-mcp-server/dist/index.js"]
    },
    "laravel-artisan": {
      "command": "node",
      "args": ["./laravel-artisan-mcp-server/dist/index.js"]
    },
    "php-composer": {
      "command": "node",
      "args": ["./php-composer-mcp-server/dist/index.js"]
    }
  }
}

最近的更新

Laravel认证MCP服务器v1.0.1（2025年12月）

主要修复：解决了阻止服务器启动的数据库连接定时问题。

问题：服务器在加载环境变量之前尝试数据库连接，导致 ER_BAD_DB_ERROR 失败。

解决方案：在中实现了延迟数据库初始化 DatabaseService 施工人员确保时间安排得当。

变化:

• ✅ 修复了延迟初始化的数据库连接时间问题
• ✅ 已添加自动 .env 使用dotenv加载文件
• ✅ 已解决JWT TypeScript编译错误
• ✅ 增强的错误处理和文档

Laravel Auth MCP Server现已全面投入运行，并准备投入生产使用。

快速开始

1. 构建所有服务器：运行 npm run build 在每个服务器目录中
2. 配置环境：更新 .env 包含数据库设置的文件
3. 测试连接：在服务器启动之前验证数据库连接
4. 使用集中式配置：所有服务器都配置在 .vscode/mcp.json 便于管理

有关详细的设置说明，请参阅各个服务器文档。