GitHub MCP Server v3

A production-ready Remote MCP (Model Context Protocol) Server for GitHub with full OAuth authentication.

This server allows Claude Desktop and Claude Web to securely access GitHub repositories using each user's own GitHub account.

Features

• ✅ Remote MCP (HTTP Streamable Transport)

• ✅ GitHub OAuth Authentication

• ✅ OAuth 2.1 Authorization Code Flow

• ✅ PKCE (S256)

• ✅ Dynamic Client Registration

• ✅ OAuth Discovery Endpoints

• ✅ Bearer Token Authentication

• ✅ Encrypted GitHub Token Storage

• ✅ Personal API Keys

• ✅ JWT Browser Sessions

• ✅ SQLite (Development)

• ✅ PostgreSQL (Production)

• ✅ Claude Desktop Compatible

• ✅ Claude Web Compatible

Architecture

Claude
    │
    ▼
Remote MCP Server
    │
OAuth 2.1
    │
GitHub OAuth
    │
GitHub API

Each user authenticates with their own GitHub account.

No GitHub Personal Access Token is required.

Supported Authentication

• GitHub OAuth

• OAuth Access Tokens

• JWT Sessions

• Personal API Keys

• Shared MCP API Key (optional)

Requirements

• Python 3.11+

• PostgreSQL (Production)

• SQLite (Development)

Installation

Clone the repository

git clone https://github.com/<your-username>/github-mcp-server-v3.git

cd github-mcp-server-v3

Create virtual environment

python -m venv .venv

Activate

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Environment Variables

Create a .env

APP_ENV=development

DATABASE_URL=sqlite:///./github_mcp.db

GITHUB_CLIENT_ID=YOUR_GITHUB_CLIENT_ID

GITHUB_CLIENT_SECRET=YOUR_GITHUB_CLIENT_SECRET

GITHUB_REDIRECT_URI=http://localhost:8000/auth/callback

JWT_SECRET_KEY=CHANGE_ME

ENCRYPTION_KEY=CHANGE_ME

MCP_API_KEY=

APP_PORT=8000

Production

DATABASE_URL=postgresql://...

Running

python -m app.main

or

uvicorn app.main:api --reload

OAuth Endpoints

Authorization

GET /authorize

Token

POST /token

Dynamic Client Registration

POST /register

Protected Resource Metadata

GET /.well-known/oauth-protected-resource

Authorization Server Metadata

GET /.well-known/oauth-authorization-server

MCP Endpoint

https://github-mcp-server-2.onrender.com/mcp

Using with Claude

MCP URL

https://github-mcp-server-2.onrender.com/mcp

Related MCP server: GitHub MCP Server

OAuth Client ID

If Claude asks for an OAuth Client ID, use:

p3FQ-WhAuYOtGbAp-8FPPJ8Q6cCQZiUqLR8xmTK9QTs

This is the public client ID for the GitHub MCP Server.

Connection Steps

1. Add a new Remote MCP Server.

2. MCP URL

https://github-mcp-server-2.onrender.com/mcp

3. If prompted, enter the OAuth Client ID:

VKmg59kQfMxcWaeoPeXuSoYWphwU_Uiq83GMBu208QE

4. Click Connect.

5. Claude redirects you to GitHub.

6. Sign in using your own GitHub account.

7. Approve access.

8. You're ready to use GitHub tools.

Important

The OAuth Client ID is shared by all users.

Each user authenticates with their own GitHub account.

Your GitHub account is never shared.

Your repositories remain private.

The server stores each user's encrypted GitHub access token separately.

Users can only access repositories they already have permission to access.

Example Prompts

List my repositories.

List my GitHub repositories.

Show repository information.

Show details for my repository my-project.

List issues.

List open issues in my-project.

Create issue.

Create a GitHub issue titled "Bug Report" in my-project.

List pull requests.

Show pull requests in my-project.

Create branch.

Create a branch named feature/login.

Security

• OAuth 2.1

• PKCE (S256)

• Encrypted GitHub Tokens

• Single-use Authorization Codes

• Expiring Access Tokens

• JWT Sessions

• Personal API Keys

• HTTPS Only

• Secure Cookies

Development

Run locally

uvicorn app.main:api --reload

SQLite database

github_mcp.db

Production uses PostgreSQL.

Deployment

Recommended platforms

• Render

• Railway

• Fly.io

• Azure

• AWS

License

MIT

Author

Developed by Nitesh kumar Pandey

GitHub: https://github.com/nitesh-kumar-pandey