MCP Gateway: API y portal de autoservicio
Este repositorio contiene MCP Gateway, una solución empresarial para exponer, administrar y consumir herramientas (APIs internas) de forma segura, escalable y auditable, con autenticación RBAC y portal de autoservicio.
Resumen
- Descripción general
- Estructura de carpetas
- Cómo girar (Desarrollo)
- Características
- Ejemplo de estructura RBAC
- Seguridad
- Documentación de la API
- Requisitos del sistema
- Documentación completa
- Buenas prácticas y observaciones
Descripción general
El MCP Gateway consta de:
- Backend: FastAPI + RBAC + JWT + persistencia JSON (compatible con NoSQL)
- Frontend: React (Vite) ejecutándose integrado con el backend (compilado en
/frontend/dist
servido como estático)
Estructura de carpetas
Cómo girar (Desarrollo)
1. Backend (FastAPI)
2. Interfaz (React)
Vaya a: http://localhost:5173 (dev) o http://localhost:8000 (prod)
3. Creación de frontend para producción
Los archivos se generarán en frontend/dist
. FastAPI puede servir estos archivos automáticamente.
Características
- Inicio de sesión JWT (usuario, administrador de grupo, administrador global)
- Gestión de grupos, usuarios y herramientas (CRUD)
- Creación dinámica de herramientas por parte del administrador del grupo
- Consumo seguro de herramientas a través del portal
- Comprobación del estado, registro y documentación automática (Swagger)
- Listo para la integración de bases de datos NoSQL y SSO
Ejemplo de estructura RBAC
Consulte data/rbac.json
para ver ejemplos de usuarios, grupos y permisos.
Seguridad
- JWT, RBAC, registro de acciones
- Listo para CORS, HTTPS, limitación de velocidad, etc.
Documentación de la API
Vaya a /docs
para Swagger o /redoc
para Redoc.
Requisitos del sistema
Consulte el archivo docs/REQUISITOS.md
para conocer los requisitos funcionales, no funcionales y comerciales detallados.
Documentación completa
La documentación detallada del proyecto está centralizada en la carpeta docs/
:
docs/REQUISITOS.md
: Requisitos del sistemadocs/API.md
: Ejemplos de uso de API y puntos finalesdocs/ARQUITETURA.md
: Arquitectura técnicadocs/SEGURANCA.md
: Seguridad y mejores prácticasdocs/GOVERNANCA.md
: Gobernanza y rolesdocs/OPERACIONAL.md
: Operación, monitoreo y resolución de problemasdocs/CHANGELOG.md
: Historial de versiones
Buenas prácticas y observaciones
- Mantenga las dependencias actualizadas.
- Utilice entornos virtuales para Python.
- Siempre construya la interfaz antes de implementarla en producción.
- Consulte la documentación de los otros módulos en
docs/
. - Consejo: utilice problemas y solicitudes de extracción para proponer cambios y mantener un historial de decisiones.
Este documento debe revisarse y actualizarse periódicamente para reflejar los cambios en el diseño.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Un puente seguro que permite que los modelos de lenguaje grandes (LLM) interactúen con las API y los servicios empresariales de forma controlada y contextualizada.
Related MCP Servers
- -securityFlicense-qualityA TypeScript-based server that provides a memory system for Large Language Models (LLMs), allowing users to interact with multiple LLM providers while maintaining conversation history and offering tools for managing providers and model configurations.Last updated -25JavaScript
- -securityFlicense-qualityFacilitates enhanced interaction with large language models (LLMs) by providing intelligent context management, tool integration, and multi-provider AI model coordination for efficient AI-driven workflows.Last updated -Python
- -securityAlicense-qualityBridges Large Language Models with Language Server Protocol interfaces, allowing LLMs to access LSP's hover information, completions, diagnostics, and code actions for improved code suggestions.Last updated -63TypeScriptMIT License
- -securityFlicense-qualityA unified Model Context Protocol Gateway that bridges LLM interfaces with various tools and services, providing OpenAI API compatibility and supporting both synchronous and asynchronous tool execution.Last updated -1Python