面向 AI 智能体场景的开源开发框架 · MIT License

让中后台管理,
AI 智能体 而生

ApeAdmin 基于 FastAPI + Vue3 打造,跳出传统后台设计思路,原生为 AI Agent 能力调用做适配。开箱即用、可插拔扩展,帮开发者快速搭建兼具业务管理与 AI 工具输出能力的应用。

快速开发
3 分钟跑起来,CLI 一键生成
专业架构
FastAPI + Vue3 前后端分离
社区庞大
插件市场持续沉淀生态
适配 AI
MCP 网关原生对接 Agent
ApeAdmin 产品截图
Core Features

开箱即用的企业级能力

底座提供权限、菜单、日志等基础设施,业务功能以插件形式独立开发与部署,同时通过 MCP 网关将管理能力暴露给 AI Agent 调用。

🛡️

RBAC 权限体系

标准五表模型(用户/角色/菜单/部门),四层权限粒度,无限层级树形菜单,超管自动通配。

四层权限菜单三类型v-permission
🧩

插件化架构

插件以 Python 包开发,自动发现、热启用禁用、ZIP 一键安装,与底座完全解耦。

load→install→registerEventBus
🔌

MCP-SSE 网关

将底座与插件能力封装为标准 AI 工具,Agent 可调用、RBAC 过滤、自动审计。

ToolsResourcesPrompts
🤖

AI 对话助手

多模型支持、流式 SSE 输出、Function Calling 工具调用循环,后台管理密钥加密存储。

DeepSeek通义千问智谱 GLM
📜

审计日志

全局请求唯一 ID 追踪、操作记录、请求耗时监控,每次 AI 工具调用自动留痕。

链路追踪耗时监控
🎨

可维护的管理平台底座

仪表盘、电商、应用中心、用户中心、组件示例五大模块,全部基于 Element Plus 重写。

仪表盘 3应用中心 13组件示例 45
Architecture

前后端分离 · 底座与插件解耦

单体应用架构 + 后端插件化扩展,双数据库驱动无缝切换,Redis 可选自动降级。

🖥️

前端 Vue3

Vite 6 + TypeScript + Element Plus + Pinia

⚙️

FastAPI 底座

RBAC · 审计 · MCP 网关 · AI 对话 · 动态路由

🧩

业务插件

独立 Python 包 · 事件总线 · 可热插拔

数据库:SQLite(开发零配置)↔ MySQL(生产)双驱动自动切换 · 缓存:Redis 缺失自动降级内存
MCP Gateway

把管理系统变成 AI 的工具

通过 MCP-SSE 网关,将底座与插件的管理能力封装为标准化 AI 工具,实现传统业务系统与大模型智能体的无缝打通。

一条 @mcp_manager.tool
让 Agent 直接接管系统

插件只需几行代码即可向 MCP 网关注册工具。AI Agent 调用时自动进行 RBAC 过滤与审计,权限安全无缝延续。

三原语支持Tools 工具调用 / Resources 资源读取 / Prompts 模板渲染
自动 Schema从函数签名自动推断 JSON Schema,无需手写
RBAC 过滤Agent 只能看到当前用户有权限调用的工具
全程审计每次工具调用自动记录请求、响应、耗时与调用者
plugin.py · 向 MCP 注册工具
@mcp_manager.tool("my_plugin_greet", "问候工具")
def greet(name: str) -> dict:
    """向指定用户问候"""
    return {"message": f"Hello, {name}!"}

# AI Agent 侧即可调用:
tools = mcp.build_tools(user)
result = await agent.call("问候小张")
# → {"message": "Hello, 小张!"}
Tech Stack

现代、稳健、可扩展

选型兼顾性能与开发效率,双数据库驱动与可选缓存让你在开发与生产间无缝切换。

⚙️后端

FastAPISQLAlchemy 2.0 asyncAlembic

🎨前端

Vue 3.5Vite 6TypeScript 5.7Element Plus 2.9Pinia 2.3

🗄️数据存储

MySQL (aiomysql)SQLite (aiosqlite)Redis 可选

📊图表

ECharts 5.6vue-echarts

🔐认证安全

JWTbcryptAPI Key 加密存储

🤝AI 协议

MCP (SSE)Function Calling

🧠AI 模型

DeepSeek通义千问智谱 GLMOpenAI

💻平台

WindowsLinuxmacOS
Plugin Ecosystem

插件化 · 让业务独立生长

插件间通过事件总线松耦合通信,支持 ZIP 上传安装,能力可路由注册、MCP 工具注册、事件监听。

🔄 完整生命周期

load → install → register → uninstall,支持热启用禁用,无需重启即可插拔业务模块。

监听 USER_LOGIN · APP_STARTUP · DB_READY

📦 ZIP 一键安装

上传 ZIP 包自动导入插件,无需手动放置文件,菜单路由动态生成。

🔗 能力开放

插件可注册自有路由、MCP 工具与事件监听器,实现能力级对外开放。

Quick Start

三分钟跑起来

默认使用 SQLite 零配置启动,无需额外安装数据库。

1
启动后端

Python 3.11+,创建虚拟环境后安装依赖,一行命令跑起 FastAPI。

2
启动前端

Node.js 18+,npm install 后 npm run dev,访问 localhost:5173。

3
登录体验

使用默认账号 admin / admin123 登录,开始管理你的系统。

terminal
# 后端
cd backend
python -m venv .venv && source .venv/bin/activate
pip install -e .
uvicorn src.main:app --reload --port 8000

# 前端
cd frontend
npm install --legacy-peer-deps
npm run dev   # http://localhost:5173

# 默认账号:admin / admin123

开始构建你的 AI 中后台

开源 · 免费 · 面向智能体场景,立即体验或给项目点个 Star。

前往 GitHub ⭐ 了解更多