MCP Gateway

by jowpereira

Integrations

  • Provides the foundation for the MCP Gateway, transforming FastAPI endpoints into MCP tools that allow LLMs to interact with corporate APIs in a controlled manner.

  • Supports project version control and distribution through Git repository cloning.

  • Hosts the FastAPI-MCP framework that this gateway is based on, allowing contribution and access to the core functionality.

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

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

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 └── ...

Cómo girar (Desarrollo)

1. Backend (FastAPI)

python -m venv venv .\venv\Scripts\activate pip install -r requirements.txt uvicorn app.main:app --reload

2. Interfaz (React)

cd frontend npm install npm run dev

Vaya a: http://localhost:5173 (dev) o http://localhost:8000 (prod)

3. Creación de frontend para producción

cd frontend npm run build

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/ :


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.

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Resumen
    1. Descripción general
      1. Estructura de carpetas
        1. Cómo girar (Desarrollo)
          1. 1. Backend (FastAPI)
          2. 2. Interfaz (React)
          3. 3. Creación de frontend para producción
        2. Características
          1. Ejemplo de estructura RBAC
            1. Seguridad
              1. Documentación de la API
                1. Requisitos del sistema
                  1. Documentación completa
                    1. Buenas prácticas y observaciones

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        A comprehensive Model Context Protocol server that bridges LLMs with self-hosted media services, enabling natural language control of TV shows, movies, downloads, and notifications while maintaining traditional API access.
                        Last updated -
                        TypeScript
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.
                        Last updated -
                        Python
                        MIT License
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.
                        Last updated -
                        5
                        Python
                        Apache 2.0
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Bridges 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 -
                        2
                        TypeScript
                        MIT License

                      View all related MCP servers

                      ID: 57bbyvzkjx