详细介绍
工具简介
AdminForth 是一款基于 MIT 协议开源、可自托管的后台管理面板框架,由 devforth 团队打造。它的核心理念非常独特:后台面板既由 AI 代理(Agent)来编写,也由 AI 代理来运行。换句话说,AdminForth 同时服务两类与 AI 代理协作的人——一类是开发者,他们让 Claude Code、Codex、Gemini 或 Copilot 等编码代理来编写管理面板;另一类是管理员或运营人员,他们让 AI 代理在面板内部直接完成数据读取、清理和写回等操作。两者共享同一个代码仓库、同一个数据库和同一套权限体系,从根本上避免了传统后台工具「只服务一方、另一方只能干点鼠标」的割裂体验。
从技术栈角度看,AdminForth 通过一条命令 npx adminforth create-app 即可创建应用,原生支持 PostgreSQL、MySQL、SQLite 和 MongoDB 四种主流数据库。生成的每个应用都会自带 AI 编码代理所需的上下文文件,包括 AGENTS.md、CLAUDE.md、llms.txt 以及 skills/ 目录,并且配置采用纯声明式对象,这意味着编码代理无需在每个会话中重新学习项目结构,就能直接新增资源、字段或插件。对于管理员侧,AdminForth 提供了 MCP Server 插件,把面板中的资源转化为 AI 代理可以调用的工具,运营人员只需用自然语言提出数据需求,代理即可在权限、校验和钩子的约束下完成操作,每个代理拥有独立且可随时撤销的密钥。
主要功能
面向开发者的 AI 友好工程结构
AdminForth 生成的每个应用都内置了面向 AI 编码代理的「说明书」文件。AGENTS.md 和 CLAUDE.md 描述了项目约定与目录结构,llms.txt 提供了面向大模型的精简文档索引,skills/ 目录则封装了可复用的技能模块。配合纯声明式的配置对象,开发者只需用自然语言向 Claude Code 或 Codex 描述需求,代理就能准确地添加资源、修改列定义或集成插件,而不必反复解释项目背景。这大幅降低了「人机协作开发后台」的摩擦成本。
面向管理员的 MCP Server 数据操作能力
AdminForth 新推出的 MCP Server 插件是其最具差异化的能力。它把面板中定义的资源(如用户、订单、产品、审计日志)暴露为 AI 代理可调用的工具,代理可以读取、过滤和写入团队可见的记录。关键在于,代理执行操作时以签发密钥的用户身份运行,因此原有的权限规则、字段校验和业务钩子全部生效,审计日志也会如实记录每一次变更。每个代理配备一个独立密钥,可单独撤销,安全边界清晰。
多数据库与开箱即用的资源管理
框架原生适配 PostgreSQL、MySQL、SQLite 与 MongoDB,开发者无需为不同数据库编写差异化代码。面板以「资源」为中心组织数据,典型的资源页面包含记录列表、字段列、角色与状态标识以及创建按钮,例如用户资源页会展示邮箱、角色(Admin、Editor、Viewer)和状态(Active、Invited、Suspended)等列,并显示记录总数,方便快速浏览与筛选。
权限、校验与审计一体化
无论是人类用户通过浏览器操作,还是 AI 代理通过 MCP 调用,AdminForth 都强制走同一套权限与校验管线。这意味着企业可以在不牺牲治理能力的前提下引入 AI 自动化:代理不能越权读取敏感数据,写入操作必须通过业务钩子校验,所有动作都会进入审计日志,满足合规与追溯需求。
实时演示与完善文档
官方提供在线 Live Demo(demo.adminforth.dev),访客可直接体验用户、订单、产品与审计日志等资源页面的交互。文档站点涵盖教程(Tutorial)、API 参考与博客,帮助开发者从入门到进阶;同时官网设有面向企业的 For business 入口,为没有专职开发团队的业务方提供支持路径。
使用方法
- 创建应用:在终端执行 npx adminforth create-app,按提示选择数据库类型(Postgres、MySQL、SQLite 或 Mongo),框架会自动生成项目骨架与 AI 代理上下文文件。
- 定义资源:在声明式配置中描述数据资源、字段、权限与钩子,或直接让 Claude Code、Codex 等编码代理根据 AGENTS.md 与 CLAUDE.md 的指引完成配置。
- 本地预览:启动开发服务器后访问 localhost:3000,即可看到类似 /resource/users 的管理面板,验证列表、创建、编辑等基础交互。
- 接入 AI 代理:安装并启用 MCP Server 插件,为每个代理生成独立密钥,将资源转化为代理可调用的工具。
- 运营与审计:管理员通过自然语言指令让代理读取或修改数据,操作受权限与钩子约束,变更记录进入审计日志,可随时撤销代理密钥。
产品优势
| 对比维度 | 传统后台框架 | AdminForth |
|---|---|---|
| 开发方式 | 人工逐行编写 | AI 编码代理按声明式配置生成 |
| 运营方式 | 人工点击页面 | AI 代理通过 MCP 直接操作数据 |
| 权限治理 | 仅覆盖人类用户 | 人类与代理共用同一套权限、校验与审计 |
| 部署模式 | 多样 | 开源 MIT、可自托管,数据留在自有数据库 |
此外,AdminForth 的「同一仓库、同一数据库、同一权限」设计让开发者与管理员围绕同一份数据资产协作,避免了两套系统之间的数据同步与权限漂移问题。对于希望把 AI 自动化引入后台运营、但又不想放弃治理能力的企业而言,这种架构具有明显的实用价值。
应用场景
- 快速搭建内部管理系统:初创团队用一条命令生成用户、订单、产品等资源页面,数小时内上线可用的后台。
- AI 辅助的运营数据维护:运营人员让代理批量清理脏数据、修正字段或导出报表,无需开发介入。
- 合规敏感行业的数据治理:金融、医疗等场景要求操作可追溯,AdminForth 的审计日志与按用户身份运行的代理机制满足要求。
- 自托管与数据主权需求:开源可自托管,数据保存在自有数据库中,适合对数据出境有严格限制的组织。


