KevinLiss/ApeAdmin

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

什么是 ApeAdmin？

ApeAdmin 是一个开源的、基于 FastAPI + Vue 3 的管理面板框架，专为现代 AI 应用而构建。它提供了您所期望的常见后台功能——用户/角色管理、菜单、审计日志、RBAC 等——但增加了插件架构和 MCP-SSE 网关，允许 AI 代理将系统功能作为“工具”来调用。简而言之，它是一个“后端即服务”，您可以在几分钟内安装完毕，然后通过 Python 插件进行扩展，将业务逻辑暴露给人类用户和大语言模型代理。

核心功能

类别	功能说明
安装向导	WordPress 风格的三步设置（数据库配置 → 站点与管理员 → 完成）。自动创建数据库，生成 JWT 密钥，并在首次运行后锁定安装程序。
RBAC	五表模型（用户、角色、菜单、部门、关联表）。四层权限检查（未登录 → 无权限 → 规则 → 数据范围）以及用于按钮级隐藏的前端 `v-permission` 指令。
插件系统	通过 `importlib` 发现 Python 包。插件可以在运行时加载/卸载，具有完整的生命周期（`load → install → register → uninstall`），并且可以作为 ZIP 文件分发或从在线插件市场安装。
MCP-SSE 网关	将注册的插件函数暴露为 AI 代理可以通过服务器发送事件调用的工具、资源或提示。Schema 从函数签名自动生成，调用受 RBAC 过滤，并且每次调用都会记录请求/响应和耗时。
AI 对话	集成多模型对话（DeepSeek、Qwen、GLM、OpenAI 或任何 OpenAI 兼容端点）。支持流式 SSE 输出、Markdown 渲染以及最多五轮的工具调用循环。模型密钥使用 Fernet 加密存储。
审计与监控	全局请求 ID、操作日志、每个 API 的延迟跟踪，以及内置的带有 ECharts 可视化图表的仪表板。
数据库灵活性	开箱即用地支持 SQLite（零配置）或用于生产环境的 MySQL；驱动程序通过 `DB_TYPE` 切换。可选的 Redis 缓存在不可用时回退到内存缓存。

适用人群？

用例	ApeAdmin 的契合点
AI SaaS 平台，需要一个安全的管理 UI 来管理用户、角色和自定义 AI 工具。
企业，希望将内部服务暴露给 LLM 代理而无需编写定制 API——只需将服务注册为 MCP 工具。
开发者，构建 AI 增强的内部工具（例如，文档检索、工作流自动化），并且倾向于使用插件模型来保持核心代码整洁。
初创公司，希望快速拥有“管理面板 + AI 网关”，而无需从零开始构建脚手架。

技术栈一览

层级	技术
后端	FastAPI, SQLAlchemy 2.0 (异步), Alembic 迁移
前端	Vue 3.5, Vite 6, TypeScript 5.7, Element Plus, Pinia, ECharts
数据库	MySQL (通过 `aiomysql`) 或 SQLite (`aiosqlite`)
缓存	Redis (可选)
认证	JWT + bcrypt 密码哈希
AI 集成	基于 SSE 的 MCP (Model Context Protocol)，支持 DeepSeek、Qwen、GLM、OpenAI 或自定义的 OpenAI 兼容端点
打包	MIT 许可证，对 Docker 友好，也可部署在裸机或通过流行的托管面板部署

快速入门（最快路径）

克隆仓库并导航到后端文件夹。

创建虚拟环境，以可编辑模式安装包，并运行 FastAPI 服务器：

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

打开另一个终端，进入前端文件夹，安装 npm 依赖并启动开发服务器：
```
cd frontend
npm install --legacy-peer-deps
npm run dev
```
访问 http://localhost:5173。由于系统是全新的，它会将您重定向到 /setup。按照三步向导操作（本地演示选择 SQLite，生产环境选择 MySQL）并完成安装。
使用您设置的管理员凭据登录，浏览 系统管理 → 插件，并尝试从内置市场安装示例插件。
要体验 AI 对话，请在 AI 助手 → 模型密钥 下添加模型密钥，然后开始对话；助手可以调用已注册的 MCP 工具（例如，system_list_plugins）。

扩展 ApeAdmin

创建插件，在 backend/src/plugins/builtin/ 下添加一个新的 Python 包。实现 PluginInterface，包含 on_load、register_routes 和 register_mcp_tools 等方法。
暴露工具，在 register_mcp_tools 内部使用 @mcp_manager.tool 装饰器；函数签名将成为 LLM 可以调用的 JSON-Schema。
发布插件，将其打包为 ZIP 文件或推送到在线插件市场，以便其他用户可以一键安装。

社区与贡献

Fork → 分支 (feat/…, fix/… 等) → PR。请遵循仓库的贡献指南进行提交风格和测试。
提供微信群用于实时支持和讨论（README 中的二维码）。

总结： ApeAdmin 是一个开箱即用、可扩展的管理框架，连接了传统的业务后端和现代 LLM 代理。如果您需要一个安全的 UI、基于插件的可扩展性，以及一种让 AI 代理将您的服务作为一等工具调用的方法，这个项目为您提供了一个坚实的基础。