home / mcp / github oauth mcp server

Github OAuth MCP Server

Provides a Github OAuth MCP server that runs locally via stdio for OAuth flow integration and debugging.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "nikhil-patil-ri-mcp-github-oauth": {
      "command": "C:\\Users\\Hp\\.local\\bin\\uv",
      "args": [
        "--directory",
        "C:\\Users\\Hp\\Github-Oauth\\src\\github_oauth",
        "run",
        "server.py"
      ]
    }
  }
}

This MCP server enables you to run a Github OAuth workflow as a local MCP service that other MCP clients can connect to for authentication-related tasks. Running it locally helps you debug, integrate, and validate your OAuth flow within your broader MCP environment.

How to use

You will connect your MCP client to this Github OAuth MCP server through its standard input/output interface. Once connected, your client can trigger the server to perform OAuth operations, receive tokens, and relay responses back to your application. For debugging, run the server in your development environment and use the MCP Inspector to step through requests and responses in real time.

How to install

Prerequisites: you need a Python project environment and the uv runtime installed on your system. The uv runtime is required to run MCP servers in stdio mode.

MacOS/Linux : curl -LsSf https://astral.sh/uv/install.sh | sh
Windows : powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Additional setup for local development

To register the server with your local Claude desktop setup, you can point Claude to the server by editing the Claude desktop configuration. This creates a local path that the Claude app can use to start the MCP server for debugging and development.

For Windows : code $env:AppData\Claude\claude_desktop_config.json
For Mac/Linux :code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Starting the Github OAuth MCP server

The server runs as a stdio process started by the uv runtime. Use the exact command and arguments shown to start the server locally.

{
  "mcpServers": {
    "Github-Oauth": {
      "command": "C\\:\\Users\\Hp\\.local\\bin\\uv",
      "args": [
        "--directory",
        "C:\\Users\\Hp\\Github-Oauth\\src\\github_oauth",
        "run",
        "server.py"
      ]
    }
  }
}

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, use the MCP Inspector to inspect requests and responses as they flow through the server.

npx @modelcontextprotocol/inspector uv --directory C:\Users\Hp\Github-Oauth run github-oauth

Inspector usage

Upon launching, the Inspector will display a URL that you can open in your browser to begin debugging.

Available tools

uv_runtime

The uv runtime is used to launch MCP servers in stdio mode. It handles the standard input/output communication with MCP clients.

inspector

MCP Inspector is used to debug MCP servers by inspecting requests and responses in real time through a browser-based interface.