KevinLiss/ApeAdmin

Apeadmin 面向现代AI应用打造的Python后台管理框架，基于 FastAPI+Vue3 设计100%开源，内置 RBAC 权限管控、审计日志等企业级基础能力。框架集成 MCP‑SSE 网关，具备强大插件生态完整，帮助开发者快速搭建兼具业务管理与 AI 工具输出能力的应用。

ApeAdmin – 专为现代 AI 应用设计的开源管理平台

是什么 – ApeAdmin 是一个全栈式、支持插件的管理框架，专为托管 AI 驱动的服务而设计。它结合了 FastAPI 后端与 Vue 3 前端，并添加了 MCP-SSE 网关，将管理功能（RBAC、插件、日志等）暴露为 AI 代理可调用的工具。简而言之，它提供了一个开箱即用的“后端即服务”（BaaS），可通过独立的 Python 插件扩展，并同时支持人类操作员和 LLM 代理访问。

核心功能

类别	你将获得
安装向导	类似 WordPress 的三步设置（数据库配置 → 站点与管理员 → 完成）。自动创建 MySQL 数据库，生成 JWT 密钥，并写入锁文件以防止重复运行。
RBAC	五表模型（用户、角色、菜单、部门、关联）。四层权限检查（未登录 → 无认证 → 规则 → 数据范围）及前端 `v-permission` 指令实现按钮级隐藏。
插件系统	通过 `importlib` 发现 Python 包插件。支持热加载/卸载、Docker 隔离部署、ZIP 上传及在线插件市场。插件可注册路由、MCP 工具和事件监听器。
MCP-SSE 网关	将内部管理 API 转换为工具 / 资源 / 提示模板，供 LLM 代理调用。JSON-Schema 从函数签名自动生成，经 RBAC 过滤，并通过一次性票据和 30 秒超时保护。所有调用均被审计。
AI 聊天助手	支持多模型（OpenAI、DeepSeek、阿里通义、智谱 GLM 或任意 OpenAI 兼容端点）。流式 SSE 输出、Markdown 渲染，支持最多五轮工具调用循环。模型密钥使用 Fernet 加密存储。
审计与监控	Request-ID 中间件、操作日志、API 级延迟追踪、可搜索的审计日志。
数据库灵活性	SQLite 用于快速本地开发，MySQL 用于生产环境；通过 `DB_TYPE` 自动切换驱动。可选 Redis 缓存，支持降级到内存存储。

架构概览

apeadmin/
  backend/          # FastAPI (async SQLAlchemy, Alembic 迁移)
    src/
      api/          # REST 端点（认证、用户、角色、插件、AI 聊天…）
      core/         # 配置、安全（JWT + bcrypt）、中间件、种子数据
      crud/         # 带 RBAC 钩子的通用 CRUD
      db/           # 引擎与会话处理
      models/       # ORM 定义（rbac、插件、AI、MCP 日志）
      mcp/          # MCP 管理器、路由、内置工具
      plugins/      # 插件接口、管理器、内置示例
      ai/           # 代理编排、函数调用循环
      schemas/      # Pydantic 请求/响应模型
      main.py       # 应用入口点（生命周期、设置模式）
  frontend/         # Vue 3 + Vite + TypeScript + Element Plus UI
    src/
      api/          # 所有后端路由的 Axios 包装器
      components/   # 头部、侧边栏等
      directives/   # `v-permission`
      router/       # 由后端菜单树动态生成的路由
      stores/       # Pinia 存储（用户、菜单、权限）
      views/        # 页面（登录、系统管理、插件市场、AI 聊天…）

设计原则是 “安装即运行” —— 未配置的实例会重定向到 /setup，写入 .env 文件，创建表，然后作为标准多租户管理系统的正常行为运行。

谁可能使用它？

场景	为什么 ApeAdmin 有帮助
AI SaaS 平台	无需编写独立 API，即可将内部工具（数据检索、用户管理、自定义业务逻辑）暴露给 LLM 代理。
企业内部工具	快速搭建一个权限感知的管理 UI，用于管理用户、部门和自定义插件，同时保持单一事实来源。
插件生态系统	团队可开发独立的 Python 插件（如数据连接器、模型包装器），自动发现并热加载，保持核心稳定。
快速原型开发	使用 SQLite 开发模式和三步向导，几分钟内即可运行一个功能完整的管理面板。

快速入门

后端

cd backend
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
uvicorn src.main:app --reload --host 0.0.0.0 --port 8000

前端

cd frontend
npm install --legacy-peer-deps
npm run dev   # 在 http://localhost:5173 提供服务

打开 URL；应用会检测到缺少配置并启动 安装向导，你可以选择 SQLite（零配置）或连接到 MySQL 实例。
安装完成后，使用你定义的管理员凭据登录，然后探索：
- 系统 → 用户 / 角色 / 菜单 / 部门
- 插件 → 市场、上传 ZIP、启用/禁用
- MCP → 工具 / 资源 / 提示模板
- AI → 添加模型 API 密钥并启动可调用你注册工具的聊天会话。

生产环境可参考 deploy/DEPLOY.md 中的 Docker/Nginx 脚本。

技术栈

层级	技术
后端	FastAPI, async SQLAlchemy 2.0, Alembic, Pydantic-Settings, JWT, bcrypt
前端	Vue 3.5, Vite 6, TypeScript 5.7, Element Plus 2.9, Pinia, ECharts
数据库	MySQL（通过 `aiomysql`）或 SQLite（`aiosqlite`）
缓存	Redis（可选）
AI 集成	通过 Server-Sent Events 的 MCP（模型上下文协议），支持 OpenAI 兼容端点
打包	MIT 许可证，后端支持 pip 可编辑安装，前端使用 npm

许可证与社区

许可证： MIT – 免费用于商业和非商业用途。
社区： 官方网站、插件市场、文档门户，以及微信群组（仓库内 QR 码）。贡献遵循标准的 fork-branch-PR 工作流，有明确的分支命名规范。

TL;DR

ApeAdmin 是一个 以插件为先、AI 友好的管理框架，让你在管理用户、权限和自定义业务逻辑的同时，自动将这些能力暴露为 LLM 代理可调用的工具。它自带 UI、安装向导和完整的插件生态系统，是任何现代 AI 核心产品的坚实基础。