examples/auth/github_oauth/README.md

GitHub OAuth Example

Demonstrates FastMCP server protection with GitHub OAuth.

Setup

1. Create a GitHub OAuth App:

   • Go to GitHub Settings > Developer settings > OAuth Apps
   • Set Authorization callback URL to: http://localhost:8000/oauth/callback
   • Copy the Client ID and Client Secret

2. Set environment variables:

   export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID="your-client-id"
   export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_SECRET="your-client-secret"
   

3. Run the server:

   python server.py
   

4. In another terminal, run the client:

   python client.py
   

The client will open your browser for GitHub authentication.