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
- Estrutura de Pastas
- Como Rodar (Desenvolvimento)
- Funcionalidades
- Exemplo de Estrutura RBAC
- Segurança
- Documentação da API
- Requisitos do Sistema
- Documentação Completa
- Boas Práticas e Observações
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
Como Rodar (Desenvolvimento)
1. Backend (FastAPI)
2. Frontend (React)
Acesse: http://localhost:5173 (dev) ou http://localhost:8000 (prod)
3. Build do Frontend para Produção
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/
:
docs/REQUISITOS.md
: Requisitos do sistemadocs/API.md
: Endpoints e exemplos de uso da APIdocs/ARQUITETURA.md
: Arquitetura técnicadocs/SEGURANCA.md
: Segurança e práticas recomendadasdocs/GOVERNANCA.md
: Governança e papéisdocs/OPERACIONAL.md
: Operação, monitoramento e troubleshootingdocs/CHANGELOG.md
: Histórico de versões
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.
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.
A secure bridge that allows Large Language Models (LLMs) to interact with corporate APIs and services in a controlled and contextualized manner.
Related MCP Servers
- -securityFlicense-qualityA 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
- -securityAlicense-qualityA 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 -PythonMIT License
- -securityAlicense-qualityA 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 -5PythonApache 2.0
- -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 -2TypeScriptMIT License