CatchAdmin 是一款基于 Laravel 13.x 和 Vue 3 二次开发的开源 PHP 后台管理系统，采用前后端分离架构，面向企业级后台场景提供开箱即用的基础能力与可扩展的模块化框架。V5.4.1 的运行环境要求 PHP 8.3 及以上。

• 系统内置了后台常用的全套能力：Token 鉴权、权限管理、动态路由、动态表格、分页封装、资源权限控制、上传下载、代码生成器、数据回收站、附件管理等。无论是内部管理系统，还是快速交付业务后台，都可以直接站在这些能力之上继续开发，大幅减少重复代码。

权限体系方面，CatchAdmin 支持菜单权限、按钮权限和数据权限，配合动态路由与资源权限控制，可让不同角色、不同用户看到不同的菜单、页面和数据范围，覆盖企业后台常见的权限控制需求。

架构上，Laravel 主要作为 API 服务层对外提供接口，业务模块之间保持低耦合。每个模块拥有独立的控制器、路由、模型与数据表，支持按模块拆分、按需加载、独立迭代。后期无论是扩展 CMS、CRM、OA，还是沉淀为企业内部业务平台，都能持续保持清晰的模块边界。

• 同时，项目封装了大量高频通用能力：统一响应、异常处理、分页封装、资源输出、代码生成等，让开发者把更多精力聚焦在业务本身。

基于 CatchAdmin，可以快速搭建稳定、规范、可扩展的管理系统，并在此基础上持续沉淀自己的业务模块。

V5.4.1 版本亮点

• 相比 V5.4.0，本次更新主要包含三项变化：新增 MCP 令牌管理、修复文件上传安全问题，以及完善用户敏感信息保护。

MCP 令牌管理

系统管理新增「MCP 令牌」功能，可以为 AI 客户端单独签发访问令牌，让客户端以指定后台用户的身份调用 MCP 工具。开发者可结合业务模块扩展工具，将后台数据接入 Agent 工作流。

• 创建令牌时可选择关联用户，并设置有效期

• 支持令牌轮换与撤销，方便更新或收回客户端访问凭证

• 令牌明文在创建或轮换后展示，便于复制并分发给客户端

• 支持查看令牌状态、过期时间、最近使用时间和 IP，了解令牌使用情况

MCP 服务支持 HTTP 接入，当前提供用户信息读取与字典列表查询两个只读工具。字典查询沿用关联用户已有的后台权限。

文件上传安全修复

本次更新补齐了本地上传的扩展名白名单与大小校验，并在分片接收和合并阶段按原始文件名检查扩展名。空扩展名及明确列出的 PHP 脚本类扩展名会被拦截。

上传校验与后台上传设置保持一致，便于统一管理允许上传的文件类型和大小。

用户敏感字段隐藏

完善用户信息输出，用户数据默认隐藏密码哈希和记住登录令牌，减少接口输出敏感信息的风险。

从 V5.4.0 升级

升级时需要同步前后端代码与项目依赖，执行系统管理模块的数据库迁移，并导入新增的 MCP 令牌菜单、分配对应角色权限。

完成升级后，在「系统管理 → MCP 令牌」中为后台用户创建令牌，将服务地址和令牌配置到支持 HTTP MCP 的客户端即可开始调用。

快速开始

# 创建项目
composer create-project catchadmin/catchadmin

# 安装项目
cd catchadmin && php artisan catch:install

# 启动项目
composer run dev

🤖 使用 AI 开发

CatchAdmin 对 AI 开发场景提供了系统化支持，内置 AI 相关的开发指引、Skills 与 MCP 文档能力。这让 Cursor、Claude Code、Codex、Windsurf 等 AI 编码助手能够更准确地理解项目结构、模块规范和开发方式，减少反复解释项目上下文的时间。

• 常见后台开发任务可以交给 AI 辅助完成：

• 根据表结构生成 CRUD 模块

• 根据 SQL 生成后端接口和前端页面

• 查询项目模块结构

• 生成菜单、权限、路由相关代码

• 辅助安装项目

• 快速定位开发规范与最佳实践

Skills 扩展

CatchAdmin 通过 Skills 将安装、代码生成、前端开发、SQL to CRUD 等高频任务标准化。项目约定会沉淀在 Skills 中，AI 可以按照 CatchAdmin 的模块规范生成代码。

AGENTS.md 标准

项目兼容 AGENTS.md 规范，方便 Cursor、Claude Code、Codex 等 AI 工具在写代码前理解项目结构、模块划分和开发约定。

实时文档获取：Context7 MCP

CatchAdmin 文档已接入 Context7 的 MCP 服务。通过 Context7 MCP 客户端，开发者可以在 IDE 或 AI 对话中实时拉取最新技术文档、API 说明和最佳实践。

通过 AI 安装项目

composer install
php artisan catch:publish:skills

• 根据使用的 AI 编码平台发布对应 Skills，然后在 AI 对话框中发送：

安装项目，数据库配置是

DB_DATABASE=数据库名称

DB_USERNAME=用户名

DB_PASSWORD=密码

AI 会基于内置指引和 Skills 协助完成后续安装与配置。

功能清单

• 用户管理：支持用户增删改，可为不同用户配置不同后台首页

• 部门管理：公司、部门、小组等组织结构树形管理

• 岗位管理：为用户配置岗位与职务信息

• 角色管理：角色树结构设计，可分配菜单、按钮、数据权限

• 菜单管理：系统菜单、按钮及权限标识配置

• 字典管理：统一维护常用固定数据

• 系统配置：管理后台常用配置项

• MCP 令牌：为外部客户端签发独立令牌，绑定后台用户并支持轮换与撤销

• 短信服务：配置阿里云、腾讯云通道，管理短信模板与验证码记录

• 操作日志：记录并查询用户正常操作行为

• 登录日志：记录登录情况，便于审计与排查

• 附件管理：统一管理上传文件与图片

• 数据表维护：支持碎片清理、优化、回收与销毁

• 代码生成：生成 PHP、Vue、数据库迁移等前后端代码，一键生成到指定模块

• Vue 即时渲染：前端 Vue 即时渲染，无需额外编译

• 插件系统：插件即 Composer 包，天然融入 Composer 生态

在线体验

演示地址：https://v5.catchadmin.com

• 超管账户：catch@admin.com / catchadmin

• 测试账户：test@admin.com / Testadmin1

项目地址

• GitHub：https://github.com/JaguarJack/catch-admin

• Gitee：https://gitee.com/catchadmin/catchAdmin

CatchAdmin V5.4.1 增加了 MCP 令牌管理，让后台业务具备接入 AI 客户端的基础能力，同时完善上传校验与用户信息保护。已有项目建议同步升级前后端，完成数据库迁移和菜单配置。