MCP Gateway

MCP 게이트웨이 – API 및 셀프 서비스 포털

이 저장소에는 RBAC 인증 및 셀프 서비스 포털을 통해 안전하고 확장 가능하며 감사 가능한 방식으로 도구(내부 API)를 노출, 관리 및 사용하기 위한 엔터프라이즈 솔루션인 MCP Gateway가 포함되어 있습니다.

요약

• 개요
• 폴더 구조
• 스핀하는 법(개발)
• 특징
• RBAC 구조 예
• 보안
• API 문서
• 시스템 요구 사항
• 완전한 문서
• 모범 사례 및 관찰

개요

MCP 게이트웨이는 다음으로 구성됩니다.

• 백엔드: FastAPI + RBAC + JWT + JSON 지속성(NoSQL 사용 가능)
• 프런트엔드: 백엔드와 통합된 React(Vite) 실행(정적으로 제공되는 /frontend/dist 에 빌드됨)

폴더 구조

지엑스피1

스핀하는 법(개발)

1. 백엔드(FastAPI)

2. 프런트엔드(React)

다음으로 이동하세요: http://localhost:5173 (개발) 또는 http://localhost:8000 (프로덕션)

3. 프로덕션을 위한 프런트엔드 빌드

파일은 frontend/dist 에 생성됩니다. FastAPI는 이러한 파일을 자동으로 제공할 수 있습니다.

특징

• JWT 로그인(사용자, 그룹 관리자, 글로벌 관리자)
• 그룹, 사용자 및 도구 관리(CRUD)
• 그룹 관리자에 의한 도구의 동적 생성
• 포털을 통한 도구의 안전한 소비
• 건강 검진, 등록, 자동 문서화(Swagger)
• NoSQL 데이터베이스 통합 및 SSO 준비 완료

RBAC 구조 예

예를 들어 사용자, 그룹, 권한에 대한 내용은 data/rbac.json 참조하세요.

보안

• JWT, RBAC, 공유 레지스트리
• CORS, HTTPS, 속도 제한 등에 대비했습니다.

API 문서

Swagger의 경우 /docs 로 이동하고 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/ 에서 다른 모듈에 대한 설명서를 확인하세요.
• 팁: 이슈와 풀 리퀘스트를 활용해 변경 사항을 제안하고 결정 내역을 유지하세요.

이 문서는 설계 변경 사항을 반영하기 위해 주기적으로 검토하고 업데이트해야 합니다.