fastmcp/examples/auth/github_oauth
Jeremiah Lowin e9aad2eacb feat: Add --workspace flag to fastmcp install cursor (#1522)
Co-authored-by: Jeremiah Lowin <jlowin@users.noreply.github.com>
Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
2025-08-19 20:10:12 +00:00
..
client.py feat: Add --workspace flag to fastmcp install cursor (#1522) 2025-08-19 20:10:12 +00:00
README.md feat: Add --workspace flag to fastmcp install cursor (#1522) 2025-08-19 20:10:12 +00:00
server.py feat: Add --workspace flag to fastmcp install cursor (#1522) 2025-08-19 20:10:12 +00:00

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.