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 & Portal de Autoatendimento

Este repositório contém o MCP Gateway, uma solução corporativa para expor, gerenciar e consumir ferramentas (APIs internas) de forma segura, escalável e auditável, com autenticação RBAC e portal de autoatendimento.


Sumário


Visão Geral

O MCP Gateway é composto por:

  • Backend: FastAPI + RBAC + JWT + persistência em JSON (pronto para NoSQL)
  • Frontend: React (Vite) rodando integrado ao backend (build em /frontend/dist servido como estático)

Estrutura de Pastas

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

Como Rodar (Desenvolvimento)

1. Backend (FastAPI)

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

2. Frontend (React)

cd frontend npm install npm run dev

Acesse: http://localhost:5173 (dev) ou http://localhost:8000 (prod)

3. Build do Frontend para Produção

cd frontend npm run build

Os arquivos serão gerados em frontend/dist. O FastAPI pode servir esses arquivos automaticamente.


Funcionalidades

  • Login JWT (usuário, admin de grupo, admin global)
  • Gestão de grupos, usuários e ferramentas (CRUD)
  • Criação dinâmica de ferramentas por admin de grupo
  • Consumo seguro de ferramentas via portal
  • Healthcheck, logging, documentação automática (Swagger)
  • Pronto para integração com banco NoSQL e SSO

Exemplo de Estrutura RBAC

Veja data/rbac.json para exemplo de usuários, grupos e permissões.


Segurança

  • JWT, RBAC, logging de ações
  • Pronto para CORS, HTTPS, rate limit, etc.

Documentação da API

Acesse /docs para Swagger ou /redoc para Redoc.


Requisitos do Sistema

Veja o arquivo docs/REQUISITOS.md para requisitos funcionais, não-funcionais e de negócio detalhados.


Documentação Completa

A documentação detalhada do projeto está centralizada na pasta docs/:


Boas Práticas e Observações

  • Mantenha as dependências atualizadas.
  • Utilize ambientes virtuais para Python.
  • Sempre gere o build do frontend antes de deploy em produção.
  • Consulte a documentação dos demais módulos em docs/.
  • Sugestão: utilize issues e pull requests para propor alterações e manter o histórico de decisões.

Este documento deve ser revisado e atualizado periodicamente para refletir mudanças no projeto.

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

A secure bridge that allows Large Language Models (LLMs) to interact with corporate APIs and services in a controlled and contextualized manner.

  1. Sumário
    1. Visão Geral
      1. Estrutura de Pastas
        1. Como Rodar (Desenvolvimento)
          1. 1. Backend (FastAPI)
          2. 2. Frontend (React)
          3. 3. Build do Frontend para Produção
        2. Funcionalidades
          1. Exemplo de Estrutura RBAC
            1. Segurança
              1. Documentação da API
                1. Requisitos do Sistema
                  1. Documentação Completa
                    1. Boas Práticas e Observações

                      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