GitHub MCP Bridge 🌉

Name: GitHub MCP Bridge 🌉
Author: vipink1203

@vipink1203

About GitHub MCP Bridge 🌉

A powerful Model Context Protocol (MCP) server for GitHub Enterprise that enables AI agents to access and manage enterprise users, organizations, and licenses.

Basic information

Config

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

{
  "mcpServers": {
    "github-mcp-bridge": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

Get all users in the GitHub Enterprise instance

Get detailed information for a specific user

Get all organizations a user belongs to

Get all organizations in the enterprise

Get email addresses for a user

Get all licenses in the GitHub Enterprise instance

Get detailed information for a specific license

Get all consumed licenses with detailed user information

Overview

What is GitHub MCP Bridge?

GitHub MCP Bridge is a Model Context Protocol (MCP) server that enables AI agents like Claude and ChatGPT to securely access and interact with GitHub Enterprise data. It provides a bridge for managing enterprise users, organizations, emails, and license information.

How to use GitHub MCP Bridge?

Install Python 3.9+, set up a virtual environment, install dependencies from requirements.txt, then set required environment variables (GITHUB_TOKEN, GITHUB_ENTERPRISE_NAME, TRANSPORT, PORT). Run python main.py or use the provided setup.sh script. For containerized use, deploy with Docker Compose alongside n8n or on Kubernetes. Configure MCP clients (e.g., Claude Desktop) via stdio or SSE transport in their settings file.

Key features of GitHub MCP Bridge

List and retrieve details of enterprise users
Access enterprise organizations and user organization membership
Retrieve user email addresses (admin privileges required)
View and manage enterprise licenses, including consumed licenses
Dual transport support (stdio or SSE)
Kubernetes‑ready and integrated with n8n workflows

Use cases of GitHub MCP Bridge

Automate enterprise user onboarding and offboarding
Monitor license expiration and consumption across organizations
Analyze organization structures and relationships
Track user permissions and access levels (user access auditing)
Let AI generate insights from enterprise GitHub data

FAQ from GitHub MCP Bridge

What are the prerequisites?

Python 3.9+ and a GitHub Personal Access Token with appropriate scopes. A GitHub Enterprise instance is optional (the public GitHub API can be used).

How do I run the server?

Set environment variables (GITHUB_TOKEN, GITHUB_ENTERPRISE_NAME, TRANSPORT, PORT) and run python main.py. Alternatively, use ./setup.sh or deploy with Docker Compose.

What transports are supported?

The server supports stdio (for direct integration with MCP clients) and SSE (Server‑Sent Events, for standalone service). The transport is selected via the TRANSPORT environment variable.

What tools does it provide?

The server exposes eight tools: list_enterprise_users, get_user_info, list_user_organizations, list_enterprise_organizations, get_user_emails, list_enterprise_licenses, get_license_info, and list_consumed_licenses.

How is security handled?

Store your GitHub token securely and use appropriate scopes. For production, consider AWS Secrets Manager or similar, and implement network policies in Kubernetes deployments.