MCP 게이트웨이 – API 및 셀프 서비스 포털
이 저장소에는 RBAC 인증 및 셀프 서비스 포털을 통해 안전하고 확장 가능하며 감사 가능한 방식으로 도구(내부 API)를 노출, 관리 및 사용하기 위한 엔터프라이즈 솔루션인 MCP Gateway가 포함되어 있습니다.
요약
Related MCP server: Model Context Provider (MCP) Server
개요
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/에서 다른 모듈에 대한 설명서를 확인하세요.팁: 이슈와 풀 리퀘스트를 활용해 변경 사항을 제안하고 결정 내역을 유지하세요.
이 문서는 설계 변경 사항을 반영하기 위해 주기적으로 검토하고 업데이트해야 합니다.