OAuth 2.1 인증 서버는 코드 수정없이 MCP (모델 Context Protocol) 서버에 인증을 추가합니다. Gateway는 OAuth Authorization Server로 사용자 인증에 대한 Identity Provider(IdP)로 GitHub를 사용하는 역할을 합니다.

第2條 第2條 第2條 第2條 第2條 第2條 第2條 第2條 第2條

⚠️ 중요 공지

**이 MCP 프로토콜에 대한 참조 구현 및 테스트 플랫폼입니다. **

-Primary Purpose: MCP 프로토콜 개발 및 테스트에 대한 참조 구현

• Experimental Nature: 미래의 MCP 프로토콜의 테스트 플랫폼으로 사용
• 보안 면책: 이 구현은 보안 모범 사례를 위해 노력하지만, 이 구현은 버그와 보안 취약점을 포함 -Production Warning: 철저한 보안 검토 없이 생산용으로 권장되지 않음
• ** 자신의 위험에 사용 **: 이것은 개발과 테스트를 위해 설계된 실험 소프트웨어입니다.

️ 건축

개요

MCP OAuth Gateway는 MCP 서버에 대한 zero-modification Layer입니다. 그것은 OAuth 2를 실행합니다.

MCP OAuth Gateway

An OAuth 2.1 Authorization Server that adds authentication to any MCP (Model Context Protocol) server without code modification. The gateway acts as an OAuth Authorization Server while using GitHub as the Identity Provider (IdP) for user authentication.

📖 View Documentation | 🔧 Installation Guide | 🏗️ Architecture Overview

⚠️ Important Notice

This is a reference implementation and test platform for the MCP protocol.

• Primary Purpose: Reference implementation for MCP protocol development and testing
• Experimental Nature: Used as a test platform for future MCP protocol iterations
• Security Disclaimer: While this implementation strives for security best practices, this implementation likely contains bugs and security vulnerabilities
• Production Warning: NOT recommended for production use without thorough security review
• Use at Your Own Risk: This is experimental software intended for development and testing

🏗️ Architecture

Overview

The MCP OAuth Gateway is a zero-modification authentication layer for MCP servers. It implements OAuth 2.1 with dynamic client registration (RFC 7591/7592) and leverages GitHub as the identity provider for user authentication. The architecture follows these core principles:

• Complete Separation of Concerns: Authentication, routing, and MCP protocol handling are strictly isolated
• No MCP Server Modifications: Official MCP servers run unmodified, wrapped only for HTTP transport
• Standards Compliance: Full OAuth 2.1, RFC 7591/7592, and MCP protocol compliance
• Production-Ready Security: HTTPS everywhere, PKCE mandatory, JWT tokens, secure session management
• Dynamic Service Discovery: Services can be enabled/disabled via configuration

System Components

┌─────────────────────────────────────────────────────────────────────────────────────┐
│                                   EXTERNAL CLIENTS                                  │
│         (Claude.ai, MCP CLI tools, IDE extensions, Custom integrations)             │
└─────────────────────────────────────────────────────────────────────────────────────┘
                                           │
                                     HTTPS │ :443
                                           ↓
┌─────────────────────────────────────────────────────────────────────────────────────┐
│                               TRAEFIK REVERSE PROXY                                 │
│                          (Layer 1: Routing & TLS Termination)                       │
├─────────────────────────────────────────────────────────────────────────────────────┤
│ • Let's Encrypt automatic HTTPS certificates for all subdomains                     │