GitHub MCP Bridge 🌉

A Model Context Protocol (MCP) server that lets AI agents (Claude, ChatGPT, etc.) query your GitHub Enterprise license data. Securely fetch license summaries, per-user details, org memberships, and enterprise roles via the /consumed-licenses endpoint.

---

📊 Capabilities & Example Prompts

• License Summary
  • "Show me our GitHub Enterprise license summary"
  • "How many licenses are we currently using?"

• Detailed License Usage
  • "List all consumed GitHub licenses"
  • "Do we have any unused GitHub licenses?"

• User Lookup
  • "What GitHub orgs does johndoe belong to?"
  • "What enterprise roles does johndoe have?"
  • "Is johndoe an owner in our enterprise?"
  • "Get detailed info about johndoe"
  • "Does johndoe have 2FA enabled?"

---

🌟 Features

• License Analytics: Total vs. consumed seats
• User Lookup: Org memberships, roles, 2FA, SAML ID
• Pagination: Handles large enterprises automatically
• Dual Transports: stdio for direct MCP, SSE for HTTP
• Kubernetes-Ready: Deploy on EKS/GKE or any K8s cluster

---

📋 Prerequisites

• Python 3.9+
• GitHub PAT with read:enterprise / license scopes
• GitHub Enterprise Cloud tenant

---

🚀 Quick Start

1. Clone & Install

git clone https://github.com/vipink1203/github-mcp-bridge.git
cd github-mcp-bridge
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Configure

cp .env.example .env
# Edit .env: set GITHUB_TOKEN and GITHUB_ENTERPRISE_URL

3. Run

stdio transport

export TRANSPORT=stdio
python main.py

SSE transport

export TRANSPORT=sse PORT=8050
python main.py

🐳 Docker & n8n

Add this service to your docker-compose.yml alongside n8n:

services:
  github-mcp:
    image: ghcr.io/vipink1203/github-mcp-bridge:latest
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_ENTERPRISE_URL=${GITHUB_ENTERPRISE_URL}
      - TRANSPORT=sse
      - PORT=8050
    ports:
      - "8050:8050"
    restart: unless-stopped
    networks:
      - n8n-network

In n8n's UI, enable the MCP client:

• Settings → Credentials → New Credential
• Choose MCP Client API, set URL to http://github-mcp:8050/sse

🔌 MCP Tools & Resources

Tools

Name	Description
list_consumed_licenses	Summarize licenses, optionally include users
get_user_organizations	List a user's GitHub org memberships
get_user_enterprise_roles	List a user's enterprise roles
get_user_detail	Full license detail for a user

Resources

URI	Description
github://consumed-licenses/{dummy}	Full license usage + user details
github://user/{username}/roles	Org & enterprise roles for a user

🤝 Contributing

1. Fork & branch
2. git commit -m "feat: …"
3. git push & open a PR

📜 License

MIT — see LICENSE

Built with ❤️ for seamless AI ↔️ GitHub Enterprise integration.