MCP Gateway – API и портал самообслуживания

В этом репозитории содержится MCP Gateway — корпоративное решение для предоставления, управления и использования инструментов (внутренних API) безопасным, масштабируемым и проверяемым способом с аутентификацией RBAC и порталом самообслуживания.

Краткое содержание

• Обзор

• Структура папки

• Как прясть (Разработка)

• Функции

• Пример структуры RBAC

• Безопасность

• API-документация

• Системные требования

• Полная документация

• Хорошие практики и наблюдения

Related MCP server: Model Context Provider (MCP) Server

Обзор

Шлюз MCP состоит из:

• Бэкэнд: FastAPI + RBAC + JWT + сохранение JSON (поддержка NoSQL)

• Фронтенд: React (Vite), работающий в связке с бэкендом (встроенный /frontend/dist используется как статический)

Структура папки

Как прясть (Разработка)

1. Бэкэнд (FastAPI)

2. Фронтенд (React)

Перейдите по адресу: http://localhost:5173 (dev) или http://localhost:8000 (prod)

3. Сборка фронтенда для производства

Файлы будут созданы в 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/ .

• Совет: используйте запросы на внесение изменений и ведите историю решений.

Данный документ следует периодически пересматривать и обновлять для отражения изменений в конструкции.