OAuth 2.1认证学习工具

一个交互式教育工具,逐步指导用户通过OAuth 2.1认证流程与MCP服务器连接。

  • by gravitee-io-labs
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 gravitee-io-labs/MCP-Auth-Playground

使用说明

MCP认证游乐场

用于学习使用模型上下文协议(MCP)服务器进行OAuth 2.1身份验证的交互式研讨会。

概述

此教育工具将逐步指导您完成连接到MCP服务器所需的OAuth 2.1身份验证流程。你会学到:

  • 受保护的资源如何响应未经身份验证的请求
  • OAuth元数据发现(RFC 9728)
  • 动态客户端注册
  • PKCE(代码交换证明密钥)
  • 授权码流
  • 代币兑换
  • 发出经过身份验证的MCP请求

建筑

graph TB
    subgraph Docker Compose
        subgraph Northbound Network
            APP[auth-playground-app<br/>React + Vite<br/>Port: 3002]
            PROXY[proxy<br/>Express.js<br/>Port: 3001]
        end
        subgraph Southbound Network
            PROXY
            INTERNAL[Internal MCP Servers]
        end
    end
    
    EXTERNAL[External MCP Servers<br/>Notion, Figma, etc.]
    
    Browser -->|:3002| APP
    APP -->|Proxy Mode| PROXY
    APP -.->|Direct Mode| EXTERNAL
    PROXY -->|Forward| INTERNAL
    PROXY -->|Forward| EXTERNAL
  • auth游乐场应用程序:带有逐步OAuth流可视化的React前端
  • 代理:将请求转发到内部Docker网络的Express服务器(南行)

快速开始

# Start the application
docker compose up -d --build

# Open in browser
open http://localhost:3002

技术栈

  • 前端:React 19,Vite 7
  • 代理:Node.js 25,Express 5
  • 容器化:Docker,Docker Compose