MCP 网关 – API 和自助服务门户

该存储库包含 MCP 网关，这是一种企业解决方案，用于以安全、可扩展和可审计的方式公开、管理和使用工具（内部 API），并具有 RBAC 身份验证和自助服务门户。

概括

概述

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 --reload

2. 前端（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/中其他模块的文档。
提示：使用问题和拉取请求来提出变更并维护决策历史。

应定期审查和更新该文件以反映设计的变化。

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

MCP Gateway