MCP 网关 – API 和自助服务门户
该存储库包含 MCP 网关，这是一种企业解决方案，用于以安全、可扩展和可审计的方式公开、管理和使用工具（内部 API），并具有 RBAC 身份验证和自助服务门户。
概括
Related MCP server: Model Context Provider (MCP) Server
概述
MCP 网关包括：
后端： FastAPI + RBAC + JWT + JSON 持久性（NoSQL 就绪）
前端： React（Vite）与后端集成运行（在
/frontend/dist中构建并作为静态服务）
文件夹结构
mcp-server/
├── app/ # Backend FastAPI
│ ├── main.py # Entrypoint
│ ├── config.py # Configurações
│ ├── auth.py # Autenticação/JWT
│ ├── utils/ # Utilitários (RBAC, dependências)
│ └── groups/
│ ├── routes.py # Rotas (APIs)
│ └── tools.py # Utilitários de permissão
├── data/ # Dados persistentes
│ └── rbac.json # Usuários, grupos, permissões
├── frontend/ # Portal React (Vite)
│ ├── src/ # Código-fonte React
│ └── dist/ # Build de produção (servido pelo FastAPI)
├── requirements.txt # Dependências Python
├── README.md # Este documento
└── ...如何旋转（开发）
1.后端（FastAPI）
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload2. 前端（React）
cd frontend
npm install
npm run dev转到： http://localhost:5173 (dev) 或http://localhost:8000 (prod)
3. 生产前端构建
cd frontend
npm run build这些文件将在frontend/dist中生成。 FastAPI 可以自动提供这些文件。
特征
JWT 登录（用户、组管理员、全局管理员）
组、用户和工具管理 (CRUD)
群组管理员动态创建工具
通过门户安全使用工具
健康检查、注册、自动文档（Swagger）
准备好进行 NoSQL 数据库集成和 SSO
RBAC结构示例
有关用户、组和权限的示例，请参阅data/rbac.json 。
安全
JWT、RBAC、共享注册表
准备好 CORS、HTTPS、速率限制等。
API 文档
转到/docs获取 Swagger 或/redoc获取 Redoc。
系统要求
有关详细的功能、非功能和业务需求，请参阅docs/REQUISITOS.md文件。
完整的文档
详细的项目文档集中在docs/文件夹中：
docs/REQUISITOS.md：系统要求docs/API.md：端点和 API 使用示例docs/ARQUITETURA.md：技术架构docs/SEGURANCA.md：安全性和最佳实践docs/GOVERNANCA.md：治理和角色docs/OPERACIONAL.md：操作、监控和故障排除docs/CHANGELOG.md：版本历史
良好实践和观察
保持依赖关系保持最新。
对 Python 使用虚拟环境。
在部署到生产环境之前，务必先构建前端。
检查
docs/中其他模块的文档。提示：使用问题和拉取请求来提出变更并维护决策历史。
应定期审查和更新该文件以反映设计的变化。