This is a simple example of an MCP server with GitHub OAuth authentication. It demonstrates the essential components needed for OAuth integration with just a single tool.

This is just an example of a server that uses auth, an official GitHub mcp server is [here](https://github.com/github/github-mcp-server)

This simple demo to show to set up a server with:

- GitHub OAuth2 authorization flow

- Single tool: `get_user_profile` to retrieve GitHub user information

1. Create a GitHub OAuth App:

- Go to GitHub Settings > Developer settings > OAuth Apps > New OAuth App

- Application name: Any name (e.g., "Simple MCP Auth Demo")

- Homepage URL: `http://localhost:8000`

- Authorization callback URL: `http://localhost:8000/github/callback`

- Click "Register application"

- Note down your Client ID and Client Secret

You MUST set these environment variables before running the server:

export MCP_GITHUB_GITHUB_CLIENT_ID="your_client_id_here"

export MCP_GITHUB_GITHUB_CLIENT_SECRET="your_client_secret_here"

The server will not start without these environment variables properly set.

uv run mcp-simple-auth

The server will start on `http://localhost:8000`.

The only tool in this simple example. Returns the authenticated user's GitHub profile information.

**Required scope**: `user`

**Returns**: GitHub user profile data including username, email, bio, etc.

If the server fails to start, check:

1. Environment variables `MCP_GITHUB_GITHUB_CLIENT_ID` and `MCP_GITHUB_GITHUB_CLIENT_SECRET` are set

2. The GitHub OAuth app callback URL matches `http://localhost:8000/github/callback`

3. No other service is using port 8000

You can use [Inspector](https://github.com/modelcontextprotocol/inspector) to test Auth

import sys

from mcp_simple_auth.server import main

sys.exit(main())