READMEmain
We couldn't render this README. Read it on GitHub
Secure MCP OAuth UI
A secure OAuth integration hub for Model Context Protocol (MCP).
Environment Setup
Frontend Environment Variables
Create an .env.local file in the root directory with the following variables:
# API Configuration
NEXT_PUBLIC_API_BASE_URL=https://api.secure-mcp-oauth.com
# OAuth Client IDs (public)
NEXT_PUBLIC_SKETCHFAB_CLIENT_ID=your_sketchfab_client_id
NEXT_PUBLIC_GMAIL_CLIENT_ID=your_gmail_client_id
NEXT_PUBLIC_TWITTER_CLIENT_ID=your_twitter_client_id
NEXT_PUBLIC_ZOOM_CLIENT_ID=your_zoom_client_id
OAuth Configuration
When setting up your OAuth providers, configure the following callback URLs:
-
For Gmail/Google:
- Callback URL:
https://your-domain.com/oauth_callback/google
- Callback URL:
-
For Sketchfab:
- Callback URL:
https://your-domain.com/oauth_callback/sketchfab
- Callback URL:
-
For Twitter:
- Callback URL:
https://your-domain.com/oauth_callback/twitter
- Callback URL:
-
For Zoom:
- Callback URL:
https://your-domain.com/oauth_callback/zoom
- Callback URL:
For local development, you can use:
http://localhost:3000/oauth_callback/googlehttp://localhost:3000/oauth_callback/sketchfabhttp://localhost:3000/oauth_callback/twitterhttp://localhost:3000/oauth_callback/zoom
Backend Configuration
The backend server requires OAuth client secrets to be securely stored in its environment:
-
For Gmail:
- Create a project in the Google Cloud Console
- Enable the Gmail API
- Create OAuth credentials (Web application type)
- Store the client secret on the backend server (never in frontend code)
- Configure the backend with:
GMAIL_CLIENT_ID=your_gmail_client_id GMAIL_CLIENT_SECRET=your_gmail_client_secret GMAIL_REDIRECT_URI=https://your-domain.com/oauth_callback/google
-
For Sketchfab:
- Register an application on the Sketchfab developer portal
- Generate OAuth credentials
- Store the client secret on the backend server with:
SKETCHFAB_CLIENT_ID=your_sketchfab_client_id SKETCHFAB_CLIENT_SECRET=your_sketchfab_client_secret SKETCHFAB_REDIRECT_URI=https://your-domain.com/oauth_callback/sketchfab
-
For Zoom:
- Create an OAuth app in the Zoom App Marketplace
- Set OAuth scopes (at minimum
user:read) - Store the client secret on the backend server with:
ZOOM_CLIENT_ID=your_zoom_client_id ZOOM_CLIENT_SECRET=your_zoom_client_secret ZOOM_REDIRECT_URI=https://your-domain.com/oauth_callback/zoom
Getting Started
# Install dependencies
npm install
# Run the development server
npm run dev
The application will be available at http://localhost:3000.
Features
- Secure OAuth integration with multiple providers
- Token management and refresh
- User authentication
- MCP compliant configuration export
MCP Integration
This application supports exporting configurations in MCP format. For more information about MCP, visit Model Context Protocol.
