AdminForth

AdminForth

免费Web
访问官网

AdminForth 是一款开源管理面板框架,支持开发者用 AI 编码代理生成后台,管理员通过 MCP 让 AI 代理直接操作数据。

AdminForth访问官网

详细介绍

工具简介

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 入口,为没有专职开发团队的业务方提供支持路径。

 

使用方法

  1. 创建应用:在终端执行 npx adminforth create-app,按提示选择数据库类型(Postgres、MySQL、SQLite 或 Mongo),框架会自动生成项目骨架与 AI 代理上下文文件。
  2. 定义资源:在声明式配置中描述数据资源、字段、权限与钩子,或直接让 Claude Code、Codex 等编码代理根据 AGENTS.md 与 CLAUDE.md 的指引完成配置。
  3. 本地预览:启动开发服务器后访问 localhost:3000,即可看到类似 /resource/users 的管理面板,验证列表、创建、编辑等基础交互。
  4. 接入 AI 代理:安装并启用 MCP Server 插件,为每个代理生成独立密钥,将资源转化为代理可调用的工具。
  5. 运营与审计:管理员通过自然语言指令让代理读取或修改数据,操作受权限与钩子约束,变更记录进入审计日志,可随时撤销代理密钥。

 

产品优势

对比维度 传统后台框架 AdminForth
开发方式 人工逐行编写 AI 编码代理按声明式配置生成
运营方式 人工点击页面 AI 代理通过 MCP 直接操作数据
权限治理 仅覆盖人类用户 人类与代理共用同一套权限、校验与审计
部署模式 多样 开源 MIT、可自托管,数据留在自有数据库

此外,AdminForth 的「同一仓库、同一数据库、同一权限」设计让开发者与管理员围绕同一份数据资产协作,避免了两套系统之间的数据同步与权限漂移问题。对于希望把 AI 自动化引入后台运营、但又不想放弃治理能力的企业而言,这种架构具有明显的实用价值。

 

应用场景

  • 快速搭建内部管理系统:初创团队用一条命令生成用户、订单、产品等资源页面,数小时内上线可用的后台。
  • AI 辅助的运营数据维护:运营人员让代理批量清理脏数据、修正字段或导出报表,无需开发介入。
  • 合规敏感行业的数据治理:金融、医疗等场景要求操作可追溯,AdminForth 的审计日志与按用户身份运行的代理机制满足要求。
  • 自托管与数据主权需求:开源可自托管,数据保存在自有数据库中,适合对数据出境有严格限制的组织。

核心功能

1
AI 编码代理友好的项目结构
每个生成的应用自带 AGENTS.md、CLAUDE.md、llms.txt 与 skills/ 目录,配合声明式配置,Claude Code、Codex、Gemini、Copilot 等代理无需重新学习项目即可新增资源、字段或插件,显著提升后台开发效率。
2
MCP Server 代理数据操作
将面板资源转化为 AI 代理可调用的工具,代理可读取、过滤和写入团队可见的记录。操作以签发密钥的用户身份执行,权限、校验与钩子全部生效,每个代理密钥独立可撤销。
3
多数据库原生支持
开箱即用支持 PostgreSQL、MySQL、SQLite 与 MongoDB,开发者通过统一配置管理不同数据库,无需编写差异化适配代码,降低多环境部署的维护成本。
4
声明式资源配置
资源、字段、权限与业务钩子均以纯声明式对象定义,结构清晰、易于版本管理,既方便人类开发者阅读,也便于 AI 代理准确理解和修改配置。
5
统一权限与审计体系
人类用户与 AI 代理共享同一套权限规则、字段校验和业务钩子,所有写操作进入审计日志。企业可在引入 AI 自动化的同时保持合规追溯能力,避免治理盲区。
6
一键创建应用
通过 npx adminforth create-app 命令即可生成完整项目骨架,自动完成数据库选择与基础配置,开发者可立即在 localhost:3000 预览资源管理界面,快速验证想法。
7
在线演示与完整文档
官方提供 Live Demo 供直接体验用户、订单、产品与审计日志等资源页面,配套教程、API 参考与博客文档,帮助开发者从入门到进阶,降低学习曲线。

优缺点分析

优点
+同时服务开发者与管理员两类 AI 代理使用者,同一仓库、数据库与权限体系避免系统割裂
+开源 MIT 协议且可自托管,数据保存在自有数据库,满足数据主权与合规要求
+MCP Server 让代理以用户身份操作数据,权限、校验与审计完整生效,安全边界清晰
+声明式配置与内置代理上下文文件,让 AI 编码代理高效参与后台开发,减少重复沟通
缺点
-作为较新的开源框架,生态插件与社区案例相对有限,遇到冷门需求时参考资料较少
-MCP 代理操作与 AI 编码代理协作属于较新范式,团队需要一定的学习与适应成本

适用人群

使用 Claude Code、Codex 等 AI 编码代理的开发者与研发团队希望通过 AI 代理直接维护后台数据的运营与管理员对数据主权和合规审计有要求的金融、医疗等行业企业需要快速搭建内部管理系统的初创公司与中小团队

常见问题

Q: AdminForth 是免费的吗?采用什么开源协议?
AdminForth 采用 MIT 开源协议,代码托管在 GitHub 上,支持自托管部署,开发者可以自由使用、修改和分发。官网同时设有 For business 入口,为没有专职开发团队的业务方提供商业化支持路径。由于具体定价信息尚未在公开来源中明确,建议访问官网了解企业版或支持服务的详细报价。
Q: AI 代理通过 MCP 操作数据会不会绕过权限?
不会。AdminForth 的 MCP Server 设计原则是「代理只是同一份数据的另一个前端」。代理执行读取、过滤和写入时,以签发密钥的用户身份运行,因此原有的权限规则、字段校验和业务钩子全部生效,所有变更也会写入审计日志。每个代理拥有独立密钥并可单独撤销,管理员可以精确控制代理的访问范围。
Q: AdminForth 支持哪些数据库?
AdminForth 原生支持 PostgreSQL、MySQL、SQLite 和 MongoDB 四种主流数据库。在执行 npx adminforth create-app 创建应用时即可选择数据库类型,框架会生成对应的项目配置。统一的声明式资源配置让开发者无需为不同数据库编写差异化代码,便于在多环境间迁移和部署。
Q: 开发者如何让 AI 编码代理参与后台开发?
AdminForth 生成的每个应用都内置 AGENTS.md、CLAUDE.md、llms.txt 和 skills/ 目录,这些文件向 Claude Code、Codex、Gemini、Copilot 等编码代理说明项目约定、目录结构和可用技能。配合纯声明式的配置对象,开发者只需用自然语言描述需求,代理就能准确添加资源、列或插件,无需在每个会话中重新解释项目背景。
Q: AdminForth 适合没有开发团队的业务方使用吗?
官网专门设有 For business 入口,面向「在经营业务而非组建开发团队」的用户提供支持路径。不过 AdminForth 本质上仍是面向开发者的框架,业务方若要充分发挥其能力,通常需要借助 AI 编码代理或外部技术支持来完成初始搭建。对于希望自托管、重视数据主权的业务团队,它是一个值得评估的选择。