MCP OAuth Gateway Documentation

MCP OAuth Gateway Documentation#

Welcome to MCP OAuth Gateway#

The MCP OAuth Gateway is a comprehensive OAuth 2.1 compliant gateway for Model Context Protocol (MCP) services. It provides secure authentication, dynamic client registration, and seamless integration with multiple MCP service implementations.

Key Features#

🔐 OAuth 2.1 Compliance#

Full implementation of OAuth 2.1 specification
RFC 7591 Dynamic Client Registration
RFC 7592 Client Management
PKCE (RFC 7636) support for enhanced security
GitHub OAuth integration for user authentication

🚀 MCP Protocol Support#

StreamableHTTP transport implementation
Support for both proxy pattern (wrapping official servers) and native implementations
Session management with secure session IDs
Multiple protocol version support (2024-11-05, 2025-03-26, 2025-06-18)

🏗️ Architecture#

Traefik reverse proxy with automatic SSL via Let’s Encrypt
Redis for token and session storage
Docker Compose orchestration
Health checks for all services
Centralized logging in ./logs directory

🛠️ Developer Experience#

Blessed trinity of tools: just, pixi, docker-compose
Automated testing with real services (no mocks!)
Sidecar coverage testing for production containers
Comprehensive justfile with 100+ commands

Documentation Structure#

Getting Started

Learn about the gateway architecture and core concepts

Overview

Development Tools

Complete reference for all justfile commands and workflows

Justfile Reference

Python Packages

Documentation for all Python packages in the gateway

Python Packages Overview

Service Implementations

Detailed documentation for all MCP and infrastructure services