MCP Server + Github OAuth

@fredrikp999

Repository

Basic information

About MCP Server + Github OAuth

Example MCP server with OAuth based on https://developers.cloudflare.com/agents/guides/remote-mcp-server/

#mcp #oauth#github-auth

MCP Server + Github OAuth config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

MCP Server + Github OAuth tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Model Context Protocol (MCP) Server + Github OAuth?

This is a Model Context Protocol (MCP) server that supports remote MCP connections with built-in GitHub OAuth, deployable to your own Cloudflare account. It serves as a reference example for integrating other OAuth providers with an MCP server deployed to Cloudflare.

How to use Model Context Protocol (MCP) Server + Github OAuth?

Clone the repo and install dependencies with npm install. Create a GitHub OAuth App, set secrets via Wrangler, create a KV namespace, and deploy with wrangler deploy. Test using the MCP Inspector by connecting to the SSE endpoint. Configure Claude Desktop or other MCP clients to connect using the mcp-remote command.

Key features of Model Context Protocol (MCP) Server + Github OAuth

Built‑in GitHub OAuth authentication for remote MCP connections
Deployable to Cloudflare Workers with persistent KV storage
Supports conditional tool availability based on GitHub usernames
Acts as both OAuth server to clients and OAuth client to GitHub
Uses Durable Objects for persistent state and authentication context
Exposes tools via Server‑Sent Events (SSE) protocol

Use cases of Model Context Protocol (MCP) Server + Github OAuth

Deploy a remote MCP server authenticated via GitHub login
Restrict sensitive tools (e.g., image generation) to specific GitHub users
Connect MCP clients like Claude Desktop or Cursor to a protected remote server
Use as a reference for integrating other OAuth providers with Cloudflare Workers

Frequently asked questions

What OAuth providers are supported?

The server ships with GitHub OAuth built‑in, but the README notes it can be used as a reference for integrating other OAuth providers.

What runtime and dependencies are required?

The server runs on Cloudflare Workers. Dependencies include the `workers-oauth-provider` library, Durable MCP, and the MCP Remote library. Local development requires Node.js and Wrangler.

Where does authentication state data live?

Tokens and authentication state are stored in a Cloudflare KV namespace (called `OAUTH_KV`) configured during deployment.

Are there any known limits?

The README notes that Claude Desktop does not yet fully support remote MCP servers and may show error messages, though tools still work. Cursor supports HTTP+SSE servers but not authentication, so the `mcp-remote` command is still required.

What transports and authentication are supported?

The server uses Server‑Sent Events (SSE) as the transport. Authentication is handled via GitHub OAuth; all authenticated GitHub users can access basic tools, while the `generateImage` tool is restricted to usernames listed in the `ALLOWED_USERNAMES` configuration.

Comments

More Developer Tools MCP servers

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app